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Visual Development Environment For 


WATCOM VX-Rexx is an easy to use visual development 
environment for creating applications that leverage the 
capabilities of OS/2 2.x and exploit the Presentation Manager 
graphical user interface. VX»Rexx combines a project 
management facility, visual designer and an interactive source- 
level debugger to deliver a very approachable and highly 
productive visual development environment. 


Design Applications 

Visually Create rich graphical 
applications quickly and easily using 
the visual design environment. With 
the visual designer, you can 
graphically create Presentation 
Manager interface objects, quickly 
customize their properties, and 
easily attach Rexx procedures using 
powerful drag-and-drop 
programming techniques. 


Integrated Development 
Environment Build, test and 

debug your application without 
leaving the development 
environment. Then package your 
application as an EXE file or PM 
macro for royalty-free redistribution. 
The power of the integrated 
development environment and 
debugger can also be used with your 
existing Rexx applications. 


Powerful Open 
Environment Enjoy the 

simplicity of event-driven 
programming together with the 
global editing capabilities 
essential for professional project 
management. WATCOM 
VX*Rexx is open and extensible 
through IBM’s object oriented 
System Object Model (SOM) 
technology. You can access all 
standard Rexx API’s including 
DB2/2, because VX»Rexx is 
based on the OS/2 2.x standard 
system Rexx. 


Highlights 


► Easy to use visual development environment 

► Create and modify objects dynamically at 
both edit and runtime 

► Powerful project management facility 

► Advanced interactive source-level debugger 

► Package your applications as EXE files or 
PM macros 

► Access to standard Rexx API’s including 
DB2/2 

► System Object Model (SOM) based object 
manager 


► Drag-and-drop programming 

► Support for multi-threaded applications 

► Include OS/2 style help and hints in your 
applications 

► Supports SAA CUA’91 objects 

► Integrated console window support for 
existing Rexx programs 

► Royalty-free run-time 

► Multiple modeless window support 

► Create PM macros for applications 
supporting Rexx as a macro language 














OS/2 Rexx 


Interactive Debugging 

If an error occurs at run-time, 
VX-Rexx will display a traceback 
pinpointing the source line where 
the error occurred. A simple click 
of the mouse will return you to the 
source edit window to correct the 
error. The built-in interactive 
source-level debugger lets you set 
breakpoints, step through code 
and watch variables to track down 
complex problems. 


WATCOM International 

415 Phillip Street, Waterloo, Ontario, Canada, N2L 3X2 
Phone: (519) 886-3700 Fax: (519) 747-4971 

'Prices and specification are subject to change without notice. Price does ml include freight and taxes where applicable. Press 
quoted in US dollars. WATCOM. the Lightning Device, and VX-Rexx are trademarks of WATCOM International Corporation, Other 
trademarks are the properties ol their respective owners. © Go-pyright 1993 WATCOM International Corporation. 


Build Professional 
Applications 

WATCOM VX«Rexx allows 
you to leverage key OS/2 features 
to create professional applications. 

Build applications that dynamically 
create and modify CU A’91 screen 
objects at both edit and run-time, 
and include OS/2 style help and hints. 

Create Multi-Threaded 

Applications Every VX«Rexx 

application contains multiple threads. 

One thread remains responsive to user 
input while others continue processing. 

In addition, VX*Rexx provides the 
ability for advanced applications to easily 
use additional threads. 
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Suggested Retail: $199* 
Call Toll Free 

1 - 800 - 265-4555 

WATCOM 


M VX*Rexx; 


The integrated visual 
solution builder for OS/2 2.x. 
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WeVe always believed Micro Focus COBOL Workbench® is the 
best in the world. Now you’ve confirmed it by unequivocally placing 
it first in the 1993 Computerworld PC Software Brand 
Preference survey. 

You voted COBOL Workbench as Best Technology 
and Easy to Use That’s not all. Workbench has also won 
top honors in Price/Performance, Best Documentation, Plan to Buy, 
and most importantly, you chose Micro Focus as the company you 
Prefer to do Business With, According to you there was no contest. 

Not surprising really. There is no better technology for developing 
new systems or re-engineering existing applications on the - 



workstation. Programmers find Workbench puts them directly in 
control of their development environment, delivering quality business 
applications on time and on budget. 

If it isn't Micro Focus COBOL Workbench, it isn't in 
the running. That’s not just our opinion, it's yours. 

For your free copy of the 1993 Computerworld survey, 
or for more information, call 8QO-MF-COBOL, (800-872-6265). 

MICRO FOCUS 

Micro Focus Inc, 2465 Fast Bayshore Road, Palo Alto, CA 94303. Tel, (415) 856 4161 

Circle Reader Service Number 2 



Micro focut tnd COBOL Wufkbflth wt registered iradtmarks of Micro Focus, Inc. Afl other tndcTmrb arc property [heir companies. 

GSA Contract Number GS0OK93AGS6403. In Canada call IBM Canada at 1-800-465-1234. 
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SourceLink v2.0 

by One Up Corporation 

SourceLink. the ultimate 32'bit programming 
development tool, combines the functionality 
of hyperlink source code access, a fully- 
functlonal editor and extensive Rle manipula¬ 
tion utilities Into one very powerful toolset. 

Now you can find code, change rode, spawn 
compiles and hyperlink directly to the source 
of error quickly and efficiently. Features 

point & click source code navigation and automatic generation of 
function call trees. 

Ust: $209 Ours: $259 FA Xmera #: 6005-0003 


Window Washer v2.0 

by One Up Corporation 

The latest version of the best-selling 32 bit 
screen saver for OS/2, with full system pass¬ 
word security and the most complete monitor 
bum-ln protection available today. Version 2.0 
features many exciting animated effects, digital 
video and audio I plays CD's. MIDI or WAV flies 
with program, effects). Also utilizes TIP* GIF. 
BMP, & PCX backgrounds, 

Ours: $35 FAXcttera #: 6005-0001 


CAREAUZER 


CAREALIZER 

by Computer Associates 

Defines a new generation, of development 
tools that handles the mechanics of 
event-driven programming, message passing, 
process sharing and other complexities 
behind the scenes. Combines a structured 
superset of BASIC extended to access 
Windows and OS/2 objects and resources, 

CA-Reallzer will help you create spread¬ 
sheets, charts, text editors, animation, 
graphics tablets and user-friendly forms from 
created and manipulated by simple commands. 

List: $295 Ours: $79 FA Xcettra #: 1004 0008 
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WATCOM VX'REXX 

by WATCOM 


Ust: $40 


WATCOM VX*REXX Version 2-0 Is an easy to 
use visual development environment for creat¬ 
ing applications that leverage (he capabilities of 
OS/2 2.x and exploit its CUA ’91 graphical user 
Interface* VX*RBXX combines a project 
management facility* visual designer and an 
Interactive source-level debugger lo deliver a 
very approachable and highly productive visual 
development environment. With the visual designer, you can create 
an attractive graphical Interface using VX*REXX’s full suite of 
CUA '91 interface objects, quickly customize their properties, and 
easily attach REXX procedures to the objects. Drag-and drop 
programming lets you write event routines without typing any code. 

List: $199 Ours: CALL FAXeefem#: 1683-0016 


Open Shutter t1.11 

by One Up Corporation 

Our easy-to-use screen capture process allows 
you to select any rectangular area, window, 
or entire desktop, and capture with a single 
user-defined keystroke or mouse click. Rotate, 
change colors, stretch/compress and then ^ 
preview your modifications. Output to printer, ^ 
clipboard, or soft copy In a variety of formats 
(BMP* ICO, TIFF, GIF, IMG. melaille. MacPaint). 

Ust: $70 Outs: $59 FAXmc™ # 



Ami Pro 3.0 for OS/2 

by Lotus Development Corp. 

05/2 users now have a native, 32-bit version of 
the award-winning Ami Pro 3.0 for Windows. 
Written from the ground up for OS/2, the new 
version of Ami Pro provides the highest level of 
word processing, networking, and development 
power among OS/2 word processors. 



6005-0002 


List: $495 
List: $129 


Upgrade: 

FA Xcttem #; 4000-0011 


Ours: $369 
Ours: $ 99 



GpfRexx 

by Gpf Systems, Inc. 

WYSIWYG visual OS/2 PM program¬ 
ming with REXX, Point and click lo 
create PM design using the full 
CUA *91 control set le.g*. Notebooks. 

Containers, etc.), as well as MulU- 
Media Controls. GpfRexx supports 
standard OS/2 features like Drag and 

Drop and Multi-Tasking as well as the extended features. Including: 
Multi-Med la, SQL (DB2/2 including Remote services), and advanced 

communications (APPC. CPI-C* EHLLAPI). No royalties. 

Ust: $247 Outs: $149 FAXcetera #: 3582 0005 
Special through March 31, 1994i 
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BY DICK CONKLIN 


The Decade of the LAN 


/ finally received my long-awaited 
ThinkPad 500 and wasted no time 
installing OS/2. This little number is 
IBM's smallest computer to date, their first 
in the sub-notebook class. 

I've always been amazed at the power of 
the smallest machines, ever since I attempted 
to earn a living by selling the infamous IBM 
model 5100 Portable Computer in my Dade 
County, Florida sales territory. After lugging 
that 55-pound sucker around downtown 
Miami for two years, I resolved that someday 
I would own a computer that was really 
portable. 

But, predicting smaller computers back in 
1976 didn't require a crystal ball. We all knew 
that someday these computers were going to 
shrink in size, have more memory, and run 
faster—for less money. Displays would have 
high-resolution color screens. Who knows, 
asynch communication speeds might exceed 
110 baud. It was just a matter of time. 

EMBRACING THE FUTURE 

Most of us accepted that mainframe comput¬ 
ers would get much smaller and desktop sys¬ 
tems would get more powerful and that 
someday, the two would meet. But few prog¬ 
nosticators in the 1970s foresaw the local area 
networks of today. The first LANs exploited 
shared resources—file and print servers. Then 
came office e-mail. Then database and appli¬ 
cation servers. And client/server applications. 


OS/2 Developer's LAN section has always 
been popular with readers. As corporate 
America embraced OS/2, it also 
accepted it as a client/server 
development platform, requiring 
a whole new set of programming 
skills. In this issue, we feature sev¬ 
eral articles on LAN application 
development. We deal with 
shared files, LAN application dis¬ 
tribution and installation, commu¬ 
nicating beyond the LAN, debug¬ 
ging a LAN application, and more on NetView 
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APIs. In our Buyers Guide, you'll find a mini- 
directory of several OS/2 development tools 
for building LAN-expIoiting applications. 



Please note that Compmoare's correct contact informa¬ 
tion is: Phone: (313) 737-7300, Fax: (313) 737-7108. 
Their product , RemoleControl/2, was listed in the 
Desktop DB2 supplement's buyers' guide. 
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Programming Insider 


In this issue's Programming Insider column, we describe what goes on under the covers of 32-bit memory 
management and show you how to apply some powerful OS/2 concepts. By DAVID REICH 


Efficient 32-bit Memory 
Management With OS/2 



David Reich 


mL m ow that software is up to speed 
Ilf with 32-bit hardware, pro- 
m V grammers are challenged to 
manage system resources efficiently. In 
the relatively new 32-bit multitasking 
world, your program is no longer the 
only one running in the system. In fact, 
you have awesome power over what 
you can do with your programs and the 
entire system. 

The flat memory model frees you of 
the segmented memory and pointer 
arithmetic you once used when working 
with large memory objects. However, 
using this new model presents hurdles 
and requires new ways of thinking, 


NO MORE SEGMENTS 

The first thing you will notice when 
comparing OS/2's 32-bit memory man¬ 
agement with prior systems—such as 
DOS—is that there are no more seg¬ 
ments. From the program's perspec¬ 
tive, a memory object is the basic unit 
of allocation. Memory objects can be 
anywhere from one byte to 512MB in 
size. (The current implementation of 
OS/2 limits each process or program to 
512MB.) An object is physically allo¬ 
cated in 4K page Increments. This 
means that a small object between one 
and 4K. in size will still occupy one 
physical page in memory. A 4K plus 1 


through 8K object will occupy two 
pages and so on. 

Memory is paged out using a modi¬ 
fied least-recently-used (LRU) algorithm. 
Changed pages are selected for disk 
swapping based on when they were last 
used. Whole memory objects are not 
paged at once; the are paged only one 4K 
page at a time, as necessary. 

16-bit Selectors , Offsets , and 
Descriptors, Let's review the terminology 
we use in a 16-bit segmented memory 
model. When memory is allocated and 
accessed, it is addressed with a 16-bit 
selector, or segment, and a 16-bit offset 
(represented as 16:16). The selector 
points to a descriptor in a table, which 
describes the physical segment. The off¬ 
set then specifies where in the segment 
the required bytes are located. 

Since segments are not uniform in 
size, a new segment allocated or 
swapped back into memory may not 
find an available space of its exact size. 
Holes, which are pockets of unused 
memory, tend to accumulate. 

NOW-UNEAR ADDRESSES 

In the 32-bit scheme, addresses are rep¬ 
resented as 0:32. That is, they can be 
viewed as a 32-bit flat offset into a huge 
linear address space. Linear space is 
mapped by a linear, or flat, 0:32 address. 
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Actually, memory addresses are imple¬ 
mented as 16:32, where one selector 
maps the entire system address space, 
but the details of that mechanism are of 
no concern to applications and are 
beyond the scope of this discussion* 
Under the covers, however, mapping is 
taking place. 

This 32-bit offset is really an ordered 
tuplet, as shown in Figure 1, represent¬ 
ing a page table, a page frame within the 
table (these two are analogous to the 16- 
bit selector and descriptor), and an off¬ 
set within the page frame. Using these 
tables and the offset, each linear address 
maps to a unique memory location, as 
shown in Figure 2* 

The tables abstract the memory loca¬ 
tions so the OS/2 memory manager can 
move pages in and out of physical mem¬ 
ory transparently. In this paged environ¬ 
ment, no further movement is needed, 
since all holes in memory are exactly the 
same size. The result is better application 
and system performance. 

PAGES AND ATTRIBUTES 

Each page has attributes. One that you 
cannot directly control is whether it is 
present in memory or paged out. This is 
a function of the OS/2 memory man¬ 
ager, You will soon see how you can 
maximize the amount of your applica¬ 
tion that is physically present in mem¬ 
ory, as compared to paged out, even in 
low-memory situations. 


Each page of a memory object has 
its own unique set of attributes. The 
attributes you can directly control 
include READ ONLY, READ/WRITE, EXECUTABLE, 
COMMITTED, and GUARD. The first three are 
self-explanatory; EXECUTABLE pages are 
also inherently READ ONLY. The COMMITTED 
and GUARD page attributes are of special 
interest in optimizing memory usage. 

OS/2 memory objects can be allo¬ 
cated as committed, which means that 
all pages referenced by the set of 
addresses returned from DosAllocWem are 
physically available. Uncommitted 
memory has linear address space 
reserved, but those page frames have no 
pointers mapped to physical memory* If 
your program attempts to use this mem¬ 
ory before you commit it, a protection 
exception is raised and the process ter¬ 
minates. An application can commit 
previously uncommitted memory either 
by calling DosSetMem to change its attrib¬ 
utes or by using guard pages, 

A guard page is a special page of 
uncommitted memory* When an 
address that maps to a guard page (one 
with the GUARD attribute) is touched, a 
guard page exception—as opposed to a 
page-not-present exception—is raised. 
The OS/2 system default exception 
handler for guard page exceptions 
does two things, as a result. First, it 
commits the page. Next, it sets the 
guard page attribute for the next page 
in the memory object. If there are no 
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Figure f . Structure of an OS/2 linear address 
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Figure 2. OS/2 linear address to physical memory mapping 


more pages, the flag Cannot Grow 
Stack is raised. 

This is how OS/2 dynamically 
grows stacks. It is also a useful 
way for application developers to 
control memory within the appli¬ 
cation, Since exception handlers 
can be registered by the applica¬ 
tion to override the system default 
handlers, you can handle guard 
page faults as you wish. 

Let's look at how you can use 
these facts and constructs in your 
programs. 

OPTIMIZING DATA IN MEMORY 

It is generally a good idea to allo¬ 
cate the memory you will need in 
your application with your own 
APIs. By sprinkling DosAllocHem and 
DosFreeMem calls all over your pro¬ 


gram, you lose two very important 
functions. First, you lose the con¬ 
trol and placement of data within 
the pages. Second, you likely will 
waste memory, since every mem¬ 
ory allocation is at least one 4Kb 
page. 

By using your own APIs for 
application memory allocation and 
deallocation, you can make intelli¬ 
gent assumptions for a more effi¬ 
cient program design. For exam¬ 
ple, your memory requests can use 
special flags—which are designed 
by you—to group frequently used 
logical blocks or data structures 
into a contiguous group of pages, 
in this way, you can maximize the 
hit rate of your most-often refer¬ 
enced data with a minimum num¬ 
ber of pages in physical memory. 


The operating system cannot make 
these kinds of assumptions about 
your program. Without good 
memory control, thrashing can 
occur, even within the application. 

You can also optimize page 
utilization by keeping an internal 
memory map and allocating 
blocks inside pages on a first fit 
or best fit basis. For example, 
when a call to your own memory 
allocation API, for example, 
MyAHocMem, is made in the applica¬ 
tion, it knows that 200 bytes are 
needed. Since there are several 
pages with 200 or more bytes 
available, a new page is not 
needed, and a suballocation of an 
existing page is sufficient. Then 
you can decide which bit algo¬ 
rithm and which page is best. 
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But don’t worry. It’s all in good clean fun. Because now there’s 
a fast, cost-effective way to create graphic, easy-to-use inter¬ 
faces for OS/2 X 2.0 applications and tools. Introducing Graphics 
Interface Kit/2 (GIK/2), an AD/Cycle* product from IBM 
Programming Systems. 

GIK/2 makes it easy to produce and manipulate symbolic 
representations of data w ithout writing a single line of Presentation 
Manager* code. It automatically generates C code, where 
you can link the graphic symbols to the application data 
they represent. This not only speeds up your development 
cycle, it also helps you create applications that are intuitive 
and easy-to-use. Simplify transaction systems. Make databases 
easy to access. Bring organizational charts to life. Track 
inventory with simple icons. Any application can be 
made easier with the right graphic front-end. And GIK/2 
can help you make it happen. 


For orders or additional information, please call 
1 800 IBM-CALL and ask for Department S71. If you 
need graphic proof, ask for our evaluation demo which, 
by the way, is rated G. 



•IBM. OS/2. AD/Cycle and Presentation Manager are registered trademarks of International Business Machines Corporation. ©1993 IBM Corp. 








































You may ask why you need to 
manage your own memory instead 
of letting OS/2 do it for you. The 
operating system will manage 
memory efficiently for the system 
and provide you with what you 
need, but that's all* For example, 
let's say you have a 2K hash table 
and a IK array that are often refer¬ 
enced together, OS/2 doesn't 
know enough to place them in the 
same page* But you can do this, 
because you know the characteris¬ 
tics of your application. 

Many of the operating system- 
provided services can be used 
within your own memory manage¬ 
ment scheme* A perfect example is 
guard pages* Let's say you are 
writing a program that could 
really use a large array to handle 
an incredibly efficient data struc¬ 
ture* But to implement this prop¬ 
erly, you need a 5MB array in 
which you'll only hit spots all over, 
at random* You could register an 
exception handler to handle guard 
page exceptions and allocate the 
entire 5MB object with the guard 
page attribute set. Your exception 
handler simply would commit the 
guard pages as they are hit. This 
way, unused pages remain uncom¬ 
mitted, yet you have the use of the 
entire range of addresses in a 5MB 
linear object. 

You can also take the guard 
page concept a step further* In this 
exception handler, you can log 
every time a new page is hit. This 
allows you to gauge the efficiency of 
your memory usage and placement 
of data structures within objects* 
You can then make algorithmic 
changes based on the results. 


You should allocate a large 
percentage of the memory you 
think you will need for the appli¬ 
cation up front. At first this may 
seem contrary to the whole 
concept of efficient memory man¬ 
agement. However, if you allocate 
memory as uncommitted and 
then suballocate or commit it as 
needed, you can make the most of 
what the system provides. Once 
you have a set of addresses 
within a set of 4K pages, you can 
keep the most-often used data in 
the same physical pages. It is 
unlikely that these will get paged 
out, even in memory-constrained 
systems, since they are being ref¬ 
erenced often* 

OPTIMIZING CODE IN MEMORY 

Now that you've seen how to 
optimize data within memory 
pages, what can you do about 
application code? Code is placed 
into memory by the OS/2 pro¬ 
gram loader, so there is not much 
you can do about code pages' 
attributes or when they are com¬ 
mitted* However, there is some¬ 
thing you can do to maximize 
how much of your code is present 
in physical memory even in 
memory-constrained situations* 
When organizing code into 
functions, observe how they 
interact* Look for the functions 
that reference each other most 
often and group them into a small 
set of pages. You can do this by 
keeping these functions in the 
same ,C {and hence, . OBJ) files and 
by carefully ordering statements 
in the *DEF file when building the 
.DLL or .EXE files. 


By grouping cross-referenced 
functions together into pages, you 
can maximize the probability that 
they will be in memory when 
needed. When one function is hit 
and a referenced function is in the 
same page, both will be resident at 
the same time. When functions are 
randomly scattered throughout the 
code, excess pages may load, hurt¬ 
ing your application's performance, 
as well as the system's performance* 

This is the same principle we 
used for data, but although code 
pages cannot be as precisely con¬ 
trolled {especially what is placed 
in them), you can still maximize 
the hit rate of resident functions. 

As you write applications, 32- 
bit memory management chal¬ 
lenges you with new ways of 
thinking about memory. For the 
first time, you have the flexibility 
to use huge data structures, free of 
contorting segments, expensive 
pointer arithmetic, and segment 
register loading. You can optimize 
performance by understanding 
how OS/2 manages memory and 
moves pages, while committing 
only what is needed to make your 
application perform well, even in 
heavily-stressed systems. 

David Reich has been with the IBM 
OS/2 development team since 1987 , He 
has worked on many parts of the system , 
supported customers and application 
developers, and traveled the world giving 
seminars and teaching OS/2. He has 
recently written Designing OS/2 
Applications, published by John Wiley 
and Sons . He can be reached on 
CompuServe at 78711632 or via the 
Internet at speedracer© vnetibm.com. 
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Corporate Study 


The insurance industry is rather conservative in its decisions. This cautious attitude extends to business 
decisions involving data processing. It seems especially significant, then, that OS/2 has become so prevalent 
in that industry. Provident Life and Accident Insurance, in Chattanooga, Tenn., moved many of its operations 
from mainframe-based COBOL applications to Workplace Shell and LAN-based OS/2 systems. Here, we talk 
to members of the Provident team and explore this momentous migration. By BRIAN PROFFIT 


Insurance Company Looks 
to Future With OS/2 



Brian Profit 


As late as 1988, virtually all of 
MM Provident Life and Accident 
M ■ Insurance's mission critical busi¬ 
ness applications resided on the main¬ 
frame. Management installed a number of 
PCs but used them primarily for personal 
productivity applications. At that point, 
the Information Resources department 
spent a lot of time thinking about where it 
needed to be in the 1990s to remain com¬ 
petitive. Bill Quintrell, manager of 
Microcomputers and Office Systems, 
knew that some applications were well 
suited for the mainframe, but many were 
better suited for and less expensive run¬ 
ning on the PC. Reading the tea leaves, 
Quintrell saw groupware and group com¬ 
puting as signs of changes to come. 

"We knew that companies would 
figure out how to take a single applica¬ 
tion and move it across the mainframe 
to PCs—letting the mainframe run its 
component and the PC component run 
on the network," Quintrell recalls. 
"These companies would be the most 
flexible, have the most choices, and 
face the least cost. We were in transi¬ 
tion from the previous focus of per¬ 
sonal productivity to the focus of busi¬ 
ness systems. Like the revolution that 
hit in the 1980s on what you could do 
with PCs, we felt that same productiv¬ 
ity boost would hit the corporation." 


CHARACTERISTICS FOR SUCCESS 

Quintrell had specific, stringent require¬ 
ments for the new systems. "We value 
high-quality production business sys¬ 
tems. Reliability is important and manag¬ 
ing that application is important. It was 
not practical to throw away our existing 
investment of applications. We needed 
fairly robust management business sys¬ 
tems, and we needed to support our 
legacy applications. 

"Our staff could not keep up with 
the explosion of PCs. We could only 
continue to install and support these 
PCs if we could automatically install 
and maintain them. We also needed to 
install from the LAN. Communications 
is very important. Multitasking is 
important and not just for the user's 
needs. If I'm doing remote maintenance 
on your system, you need to be able to 
keep working. The users knew GUIs 
were becoming important, but on a 
DOS base it was complex, with device 
drivers and memory managers. They 
had to learn too much about the PC 
itself, rather than how to use it as a tool. 

"It was an easy decision. We felt that 
OS/2 was the only choice for our environ¬ 
ment. It was a more mature operating sys¬ 
tem and allowed us to buy or write robust 
business applications. Most importantly, 
there were absolute requirements to create 
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Figure 1. A view of Polaris 


large-scale, line-of-business applica¬ 
tions that were founded in coopera¬ 
tive processing. If I am to split an 
application between the mainframe 
and the micro and deliver it faster or 
lower the cost, I need a PC system 
with strong communications, better 
data management, and higher relia¬ 
bility than the users themselves 
require. Clearly, corporate develop¬ 
ers would absolutely demand and 
data processing professionals would 
absolutely require something like 
OS/2." 

EVOLUTION, NOT REVOLUTION 

To get where Provident wanted to be 
was a challenge. Like most compa¬ 
nies, Provident couldn't afford to 
throw out all of its existing PCs and 
buy new ones. Instead, it threw out 
the underlying philosophy that had 
guided its PC purchases. 

"We drove a stake into the 
ground in 1988," Quintrell recalls. 
"From then on, everything we 
invested in—hardware, software, 
and people—would fit in with the 
enterprise-connected, host-inte¬ 


grated OS/2 environment we 
wanted. We didn't attempt to con¬ 
vert our existing personal productiv¬ 
ity systems to the new model—it 
wasn't practical. So, we created par¬ 
allels. On one side was the existing 
base of DOS programs that immedi¬ 
ately went into maintenance mode— 
no enhancements or updates. On the 
opposite side was the new path of 
buying, building, and installing 
OS/2 and the networks we needed 
to stay competitive." 

The commitment was made 
near the end of 1988. In early 1989, 
Provident began to make the 
changes. "The first piece we installed 
was LAN Server. It was November, 
1989 before we started installing 
OS/2 user stations. Our core prod¬ 
ucts were not available on OS/2—it 
wasn't until then that OS/2 was 
ready for what we needed. 

"From that point, we could 
architect our base components. The 
changes meant that all servers go 
into the glass house and all LANs are 
connected by a corporate backbone. 
That's a lot of wire. The operations 


staff was trained for backup and dis¬ 
aster recovery. There were new avail¬ 
ability needs for our servers. As you 
can see, there was a lot of infrastruc¬ 
ture that had to be created." 

Some of the cost-conscious 
users questioned the data process¬ 
ing staff about the size and power of 
the new PCs. They didn't see the 
need for that much power for the 
personal productivity applications 
they were running. 

"That was purely an issue of 
education," laughs Quintrell. "We 
communicated that we knew what 
we were installing wasn't being 
exploited then but would be in the 
near future." Slowly, each PC was 
upgraded to an OS/2 LAN system. 

FORSAKING THE MAINFRAME 

In early 1990, Provident reorganized, 
splitting Long Term Disability busi¬ 
ness from Group Medical and creat¬ 
ing a separate operating unit. Then, 
the disability business was sup¬ 
ported by the Group's mainframe 
systems, and the new operating unit 
wasn't satisfied. Jim Cook, who is 
director of Disability Systems, says 
that this restructuring provided a 
perfect opportunity to review the 
data processing. There were also 
concerns about having Provident's 
data processing needs managed by a 
different business unit. Platforms 
other than OS/2, however, were 
never a consideration. 

"The decision was whether we 
should do our data processing on 
the mainframe or the PC," Cook 
says. "We looked at what it was 
costing us mainframe-wise, what it 
would cost on the PC, and the type 
of business we were doing. We 
looked at our needs and things like 
graphical user interfaces that make 
it easier and more intuitive for the 
user. Based on those considera¬ 
tions, we decided that we should 
develop in the PC environment. 
We felt we could build systems 
faster and that they would be more 
user-friendly. We also felt we could 
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be more flexible and responsive to 
the changing business conditions 
more quickly in the PC environ¬ 
ment. After that, OS/2 was the 
only choice. Bill Quintrell's group 
had OS/2 networks set up, and 
they recommended that OS/2 was 
the only operating system that 
would really be able to handle our 
applications." 

EARLY TOOLS CREATED PROBLEMS 

Following the Information Resources 
group's lead. Cook's organization 
began its development using 
Borland's Paradox on OS/2 1.1. The 
group developed its proposal gener¬ 
ation and contract issuance systems 
but concluded, in the third quarter 
of 1990, that Paradox wouldn't be 
able to handle the volumes they 
needed. It also could not provide as 


much function as was required. 
After searching, they switched to 
IBM's Database Manager/2. 

"We started over again, in terms 
of our application development," 
Cook recalls. "We looked at build¬ 
ing an integrated database and data 
dictionary and started from the bot¬ 
tom. Over the next year and a half 
we developed most of the process¬ 
ing systems that we needed to get 
off the mainframe." 

Cook's organization deployed 
the software through a gradual roll¬ 
out, like Quintrell's hardware tran¬ 
sition "We did it piecemeal, with the 
proposal generation and contract 
generation first. We followed up 
with the administrative systems: the 
claims processing system, financial 
systems, and accounting systems." 

Unfortunately, the switch to 


Database Manager/2 may have 
fixed the underlying data storage 
problems, but the actual application 
development was still a problem. 
All the programming expertise was 
in mainframe COBOL, and the 
learning curve and tool immaturity 
worked against the developers. 

"We encountered a lot of prob¬ 
lems because we developed this with 
Micro Focus COBOL," Cook says. 
"At that time, the API calls were not 
converted to COBOL; they were all 
in C. We couldn't find documenta¬ 
tion on how to interface to the APIs 
with COBOL. We had to work our 
way through virtually all of those 
APIs and figure out how to convert 
them to COBOL. The technical sup¬ 
port from Micro Focus has gotten 
better, but at the time we were on 
our own to figure out how the inter- 
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nals of the code worked. The concept 
of messaging and the kind of mes¬ 
sages generated were foreign to us. 
There were months where we were 
saying 'we can't do it/ but we kept 
moving forward. One by one, we 
solved the problems." 

Provident did get help with the 
graphical interface code, though. 

"We used CASE:PM for COBOL 
[since renamed KASE:PM], which 
helped quite a bit. That's basically a 
code generator that created the code 
for the graphical portion of the pro¬ 
gram. We were the first users of the 
product to develop production sys¬ 
tems with it. We probably would 
have given up without it." 

Interestingly, when they 
decided to do programs in C, they 
selected GPF Systems' Gui 
Programming Facility (Gpf) as their 
code generator, rather than 
KASE:PM for C. 

"One factor was cost," Cook 
says. "Gpf was cheaper than 
KASE:PM. And the people that 
evaluated and developed our stan¬ 
dards liked Gpf better. They felt it 
was better on the regeneration than 
KASE:PM was. Since then, 
Kaseworks released a VIP version 
that is probably as good as Gpf, but 
we don't see any reason to change, 
and it is still more expensive." They 
also got help from Intersolv's 
PanLCM version control system, 
essentially a PC-based version of 
their Panvalet mainframe product. 

UPDATING THE INFRASTRUCTURE 

With the assistance of Information 
Resources, Provident built the hard¬ 
ware base required simultaneously. 
It has 125 users connected to the 
network, virtually all of which are 
PS/2 model 70s. Provident has six 
PS/2 model 95 servers on an IBM 
token ring network, one of which is 
a domain controller, one a print 
server, and four database servers. 
Some of the users—particularly 
actuaries who use large spreadsheet 
models and Pioneer Software's Q+E 


query tool extensively—need more 
power and are updating their sys¬ 
tems with new 486 motherboards. 

Provident updated the software 
base as well. They migrated to OS/2 
1.3 in January of 1992, moved to 
OS/2 2.0 later that year (made eas¬ 
ier by their early commitment to 
hardware that supported that plat¬ 
form), and updated to OS/2 2.1 last 
year. The move to the 32-bit plat¬ 
form also allowed Provident to 
upgrade their database to DB2/2. 

GETTING USERS UP TO SPEED 

Due to a corporate commitment to 
OS/2, Quintrell's organization pro¬ 
vided training on the operating sys¬ 
tem at its corporate training facility. 
This—combined with aggressive use 
of Workplace Shell features such as 
notebooks and the Information 
Presentation Facility for on-line 
help—made Cook's job of training 
users on the new Long Term 
Disability system, called Polaris, 
simpler. Polaris is shown in Figure 1. 

"The training needs were mini¬ 
mal because the systems were so 
intuitive in their design," Cook says. 
"Generally, we could just bring the 
user group into our large-screen 
conference room and walk them 
through the system and answer 
their questions. Then they went 
back to their desks and worked 
with the system in test mode, and in 
most instances that alone was suffi¬ 
cient for training." 

This is a nice contrast to the 
efforts required for mainframe sys¬ 
tems. "The training needs have been 
reduced. The users take to it quickly. 
They find it fun to be working on 
these systems. With any new toy 
there is greater receptivity, but they 
have been very receptive to it." 

To make sure the excitement 
doesn't fade after the newness 
wears off. Cook surveys users quar¬ 
terly. "The feedback is very posi¬ 
tive," Cook reports. "They say they 
could never go back to the main¬ 
frame, they love how easy it is to 
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use, how much information they 
have available, and so on." 

TAKING IT TO REMOTE OFFICES 

Now that Polaris has become popu¬ 
lar at headquarters. Cook is chal¬ 
lenged to get it to remote offices. In 
fact, Cook says this is "the biggest 
issue we face in 1994. We have not 
yet given remote access to our net¬ 
work, and because of cost consider¬ 
ations and the way our field offices 
are set up, it's not cost effective to 
do that with the technology that's 
available right now. 

"We looked at the bridge and 
router technology. We estimate it 
will cost anywhere between $12,000 
and $20,000 per office to do that, 
and in a lot of our offices we may 
only have one machine that needs 
connectivity to the Long Term 
Disability network. That's not very 
cost-effective. We could do it on a 
dial-up basis, but we have reserva¬ 
tions about that also: from a security 
standpoint, we're concerned about 
exposure. Even if it's only one 
workstation, if it's in California and 
has to be connected eight hours a 
day, it is expensive as well. 

"We tested IBM's LAN Distance 
as a potential dial-up solution but 
had problems with it. We also 
looked into using Distributed Data 
Connections Services/2 (DDCS/2) 
communications software, but it 
didn't work well with our applica¬ 
tions. We developed [the applica¬ 
tions] to exploit OS/2 with multiple 
programs running concurrently. In 
the way DDCS/2 works with syn¬ 
chronous data link control (SDLC), 
though, it recognizes that as multi¬ 
ple sessions. However, SDLC will 
only recognize a single session. We 
hoped to shadow our databases on 
DB2 and let the remote offices come 
in through their mainframe connec¬ 
tion. However, [SDLC] couldn't rec¬ 
ognize multiple sessions, so it 
would disconnect. We may still do 
that, but we would have to redesign 
our applications." 


OS/2 PROVIDES FOR PROVIDENT 

Quintrell identifies four separate 
needs in an information system, "We 
need to see that the user's needs are 
met, the line level or department 
needs are met, the corporation's 
heads of individual business units' 
needs are met. We also need to meet 
the data processing audit require¬ 
ments, The best approach is to 
deliver a system that balances the 
four needs. You can't sacrifice any of 
them. Other operating system and 
application vendors don't under¬ 
stand the need for this balance as 
well as IBM does; they focus only on 
the user. The corporate market 
clearly has a different objective than 
the user. When you buy a PC and 
put it on the desk, the hardware is 
the cheapest part. The user adminis¬ 
tration is by far the greatest. 

"OS/2 is a balanced system, 
with DOS, Windows, 32-bit, and the 
strongest communications of any 
operating system. It has high relia¬ 
bility and security. If you're just 
going for personal productivity, you 
may look at DOS/Windows. If you 
want something with high-end pro¬ 
gramming, you might get an engi¬ 
neering station. If you want high 
reliability and processing power, 
you might took at mainframes. If 
you have to balance all of these 
needs, OS/2 is the clear choice," 

Still, while happy with OS/2, 
Quintrell hopes that IBM is not 
complacent, "We need for IBM to 
keep OS/2 focused. Embedding 
technology is critical They've got a 
lot of talk and presentations, but to 
make people wait until 1995 for 
something similar to what was in 
version 1 of OLE is inexcusable. IBM 
is working on bidirectional printing 
and more printer drivers than the 
300 already there, but what are they 
doing to improve the product for 
those of us printing already? I'd like 
to see my word processor put out 
page one on letterhead and page 
two on plain paper. How can OS/2 
prevent an application from a mid¬ 


job forms change? Wordstar was 
doing that when Moses was print¬ 
ing the commandments. The old 
IBM would have been responsive 
to that. The new IBM is concentrat¬ 
ing too much on the mass market." 

Brian Proffit has been in the computing 
industry for 20 years . He was part of IBM's 


OS/2 team but left to become the director of 
PC Week’s Corporate Labs. He is now presi¬ 
dent of Visionary Research . Proffit is the 
author of OS/2 Application Development 
Tools andOS/2 Inside & Out. He has written 
for PC Week. Dr Dobb’s Journal and 
Programmers Paradise and is a contributing 
editor for OS/2 Magazine. He can be 
reached on CompuServe at 75300\ 1466 
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The NFS product on OS/2 does not support remote file locking. As a result mutual exclusion is not enforced 
among the different components of a distributed system when they attempt to update the same file via NFS. 
This article presents some practical algorithms to cope with the problem. The algorithms represent a variety 
of performance vs. convenience and safety tradeoffs one can make. By HARIMADDURI 


Locking Network File 
System Files on OS/2 



r he Network File System (NFS) is a 
distributed file system that allows 
users to access remote files as if 
they were local files. Using NFS, a 
server machine exports a directory tree 
of files, and the client machines access 
those files via the mount command. 

The NFS product on OS/2 does not 
support remote file locking. As a result, 
mutual exclusion is not enforced between 
a local process accessing a local file and a 
remote process accessing the same file via 
NFS. Lack of mutual exclusion can cause 
problems for distributed applications that 
need to update shared files in exclusive 
mode. In this article, we present very 
practical algorithms to cope with this 
problem. Many of these algorithms do the 
job, but they cannot be proven correct. 
That is, theoretically, there are situations 
under which they fail, while in practice 
they might work all the time. 

The algorithms presented in this 
article are of special value to users of 
persistent SOM and DSOM objects 
whose data is stored in NFS files, since it 
is the user's responsibility to protect 
such data from concurrent updates by 
multiple processes or workstations. 


THE PROBLEM 

Assume that we have a shared file (in 
genera], a network-wide resource) that is 


used by multiple processes in a distrib¬ 
uted application. The processes may be 
located on multiple machines. Processes 
located on remote machines access the 
shared file through NFS. The file's local 
machine exports the directory (or drive) 
containing the file, and the remote 
machines "mount" the exported file sys¬ 
tem onto a node in their local directory 
tree. Assume further that no process uses 
the shared file for more than Delta sec¬ 
onds at a stretch, where Delia can be set 
depending upon the application. All 
processes are required to adopt the fol¬ 
lowing protocol to use the shared file: 

L Open the shared file SF with exclusive 
write lock. 

2. Use the file (a maximum time limit of 
Delta seconds). 

3. Close SF and release the exclusive 
write lock. 

The problem is that when a remote 
process and a local process both try to use 
the file, they both can get a lock to the file 
and start updating the file. (This is a prob¬ 
lem with the current implementation of 
TCP/IP and NFS product [v.1.2.1]. It may 
not be a problem in the future releases.) 

THE SOLUTION 

We will build a comprehensive solution 
by starting with a simple algorithm and 
enhancing it step by step. Depending on 
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the requirements of the application 
domain, any intermediate point in this 
gradual refinement can serve as a satis¬ 
factory solution. For ease of explanation, 
we present the initial algorithm and all 
refinements using either pseudocode or 
simple flow charts. Finally, we present 
an implementation of a more complete 
solution in C. 

ALGORITHM I 

The first solution is based on the simple 
idea that files in a network file system can 
be used as network-wide semaphores. In 
step one of the protocol, we can create an 
auxiliary file. Lock file, and use its pres¬ 
ence to indicate that the shared file is 
being used. The Lock file can be deleted in 
step three. If two processes, one local and 
the other remote, try to create the Lock file 
at the same time, only one will succeed 
and the other will fail. This is so because 
file creation is supposed to be atomic in 
all file systems. The failed process has to 
wait at least Delta seconds (assuming 
Delta is the maximum time for which the 
shared file can be used by a process) and 
retry. Thus, the algorithm is: 

1. Create a Lock file LI; if not successful, 
return(failure). 

2. Open the shared file SF. 

3. Use the file (a maximum time limit of 
Delta seconds), 

4. Close SF, 

5. Delete LI. 

When the algorithm returns with a 
failure indication, we wait for Delta sec¬ 
onds and reexecute the algorithm. This 
algorithm is simple and works so long as 
all processes follow the protocol strictly. 
Also, if we are not concerned about toler¬ 
ating process and machine failures, then 
this algorithm is sufficient for coping with 
the locking problem. However, if we want 
to be fault tolerant, then we run into prob¬ 
lems. Consider what happens if a process 
creates LI, uses SF, and dies before deleting 
LI. The remote processes wanting to create 



LI will wait forever since they keep failing 
to create. You can modify the algorithm so 
that it repeats only a finite number of 
times and then quits with some error mes¬ 
sage to the user. The user can then manu¬ 
ally delete LI and restart the process. It 
would be nice to be able to do this auto¬ 
matically without user intervention. The 
next algorithm attempts this automation. 

ALGORITHM ft 

This algorithm builds on the previous 
one. The trick here is to recognize an old 
Lock file and delete it. 

1. Create a Lock file LI, 

2. Open the shared file SF. 

3. If not successful, do LockRemoval- 
Algorittim and return (failure). 

4. Use the file (a maximum time limit of 
Delta seconds). 
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5. Close $F, 

6. Delete LI. 


LockRemovalAlgoritlirii I: 

1. Ti = Creation time of LI; TC = 
Current time 

2, if {(TC -Tl) > Delta) LIDU - True; 
else LiOld - False; 

3, if LlULd, Delete LI; 

4. return; 

As before, when it returns 
with failure, we wait for Delta sec¬ 
onds and reexecute the algorithm. 
This algorithm looks reasonable, 
but it has two problems. One is 
that if the clocks on different 
machines are not synchronized 
(which is not uncommon), then it 
is possible to have one of the 
processes delete LI while another 
process is still using the shared file 
$F (that is, erroneous deletion of 
Lock file LI). 

The other problem is that 
even if the clocks are synchro¬ 
nized, an erroneous deletion of LI 
can occur. For example, assume 
processes PI and P2 (both remote) 
are executing Lock Remo valAlgorithm 
at the same time. Further assume 
that both of them have concluded 
that LI is old and are about to 
delete LI. Let's say that PI gets 
swapped out at this point and P2 
continues. P2 deletes LI, goes 
back, creates Li, and starts using 
$F. PI now starts running again 
and deletes Li. But this Li is new, 
since it has been created by P2! 

The first problem of unsyn¬ 
chronized clocks on different 
machines can be solved. Instead of 
calculating Delta as simply the dif¬ 
ference between the current time 
and the time of creation of the lock 
file, you can use the following algo¬ 
rithm. Assume that there is always 
a timestamp written in the lock file. 

1. Open the lock file and write the 
current timestamp into it 

2. Wait for Delta seconds and see if 
the timestamp in the lock file has 
changed. 

3. If it hasn't, then conclude that 



Figure Z An implementation of the algorithm in C (continued on page 22) 
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the lock file is old* If it has, then 
it is not old* 

(For added robustness, include 
the process ID of the attempting 
process in the timestamp*) 

The second problem of erro¬ 
neous deletion of LI is hard to 
solve. In a distributed system, with¬ 
out the aid of any locking or refer¬ 
ence entity (such as a process or an 
agent), it is impossible to be sure 
that the two operations of checking 
the file's age and deleting the file 
are done on the same file! The fun¬ 
damental problem is that you don't 
have an atomic action that brackets 
the two operations (determining 
Li's age and deleting LI). 

We can, however, try to mini¬ 
mize the probability of an erroneous 
deletion* Consider this algorithm, 
LockRemovaUQgorithm II: 

1. T1 = Creation tune of LI; TC = 


Current time 

2* Set process Priority to its maximum 
limit 


3*if ((TC -Tl) > Delta) LlOld = True; 
else LlOld = False; 

4. if LlOld, Delete LI; 

5. Restore Priority, return; 

With this modification in the 
LockRemovalAlgorithm, we have 
greatly reduced the probability of 
erroneous lock file deletion* 
Because of the high priority of the 
process the steps three and four 
are executed in quick succession, 
thereby minimizing the chance of 
process scheduling playing havoc 
at this point* It is still possible for 
two or more processes to execute 
the preceding algorithm and arrive 
at step three at the same time. 
They may all conclude that LI is 
old, but only one of them success¬ 
fully deletes LI and the others fail 
on delete* 

They can still return to the 
main algorithm and retry creating 
LL We say the probability is greatly 
reduced since processes cannot 
decide that LI is old and wait for 
too long before actually deleting LI 
(due to their high priority, they 



Figure 2. An implementation of the algorithm in C (continued on page 24) 
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must run quickly and finish the 
steps). However, the algorithm is 
still not bullet-proof since there can 
still be communication delays for 
NFS messages accomplishing the 
file operations. 


ALGORITHM lit 

We present another algorithm that 
is designed to further increase 
safety against erroneously allow¬ 
ing two processes to use SF. We use 
the idea of a second lock file, L2, to 
ensure that only one process gets 
the right to delete the original lock 
file, LI. Also, in this algorithm we 
combined the lock removal algo¬ 
rithm with the main algorithm. 

Figure 1 illustrates the new 
algorithm. LI and L2 are lock files, 
T1 and T2 are their creation times, 
Tc is the current time. Delta is the 
upper bound on SF usage time. A 
return value of 0 means success 
and -1 means "wait (at least Delta 
seconds) and retry." 

The improvement here is that 
when we find LI to be old, we 
don't attempt to delete it directly. 
Instead, we create another lock 
file, L2 and then delete LI. The cre¬ 
ation of L2 ensures that when sev¬ 
eral processes race to delete LI, one 
succeeds and the rest fail and retry 
creating LI. Even if they lose the 
race to create L2, it is still possible 
for one of those processes to create 
LI successfully and access the 
shared file SF. 

The problem of a having an 
old lock file in the current direc¬ 
tory still persists. We have devised 
a method for getting rid of a left¬ 
over Li, but we face an equivalent 
problem with a leftover L2. To cope 
with this problem, we use 
LockRemovalAlgorithm II on L2. 

This algorithm is better than 
the earlier one for the following 
reasons. LockRemovalJUgorithm IX, like 
the earlier algorithms, still suffers 
from a problem: we cannot be 
completely sure that the file we 
are deleting is the same as the one 



Figure 2. An implementation of the algorithm in C {continued from page 22) 


we looked at in the preceding 
steps. This problem is inherent in 
the environment. However, we 
have the following improvement. 
LI is protecting the resource (SF) 
directly and L2 is only protecting 
the deletion of LI. Since we have 


shifted the problem from LI to L2 
now, the probability of erroneous 
access to the shared resource (SF) is 
greatly diminished. It is true that 
multiple processes can now 
attempt to delete a leftover L2, but 
regardless of which succeeds in 
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deleting L2, we achieve our desired 
goal of getting rid of L2. 

Even this algorithm can be 
shown to fail by constructing a 
particular sequence of events. For 
example, assume that three 
processes, PI, P2, and P3, decide to 
delete L2, and the first of them, PI, 
deletes L2 and reexecutes the algo¬ 
rithm. Let's say P2 fails to delete L2, 
reenters the algorithm, sees an old 
LI, and waits just before creating L2. 
Let's say PI creates L2, deletes LI, 
reenters the algorithm, creates LI 
again, and starts using the shared 
file SF. P3 can now delete L2, clear¬ 
ing the way for P2. P2 will now exe¬ 
cute the same steps as PI and will 
access the shared file SF concur¬ 
rently with PI! 

Of course, this requires the 
process scheduling to delay 
processes by the right amount to 
make it all happen, but it is possi¬ 
ble, theoretically. Even if you raise 
the priority of the processes execut¬ 
ing this algorithm to be the high¬ 
est, you can still be delayed by 
unknown amounts due to the net¬ 
work. But practically speaking, the 
probability of this algorithm failing 
is extremely small. Figure 1 illus¬ 
trates Algorithm III. 


AN IMPLEMENTATION 

An implementation of the algo¬ 
rithm in C is given in Figure 2. 
(To conserve space in the article, 
we have not shown the imple¬ 
mentation of some simple func¬ 
tions and some declarations.) The 
implementation incorporates the 
algorithm for taking care of 
unsynchronized clocks and also 
minimizes the undesirable inter¬ 
ference from process scheduling. 
The implementation also does 
some simple optimizations rather 
than a straight one-to-one map¬ 
ping of the algorithms presented. 
The first file, pprlock.c, is a mod¬ 
ule that implements locking with¬ 
out any specific knowledge of the 
shared resource. It only requires 



Figure 3. A test program for the algorithm 

that the name of the resource be 
passed in as a parameter. Also 
before using the algorithm, one 
should pass in a maximum-resource- 
usage-time value. 

The second file, tstpprlock.c, 
has a driver main program that 
exercises the lock and unlock 
functions provided in pprlock.c. 
By running two or more instances 
of this program, you can see how 


contention for a common resource 
is resolved by the lock implemen¬ 
tation. Several optimizations are 
possible in the given implementa¬ 
tion. For example, you could 
build a common function to 
replace process.lockl and 
process_lock2. Users can also tailor 
this implementation to suit their 
needs and either make the algo¬ 
rithm even more leak-proof by 
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running the lock removal portion 
of the algorithm in a critical sec¬ 
tion or relax it by doing away 
with process_lock2 calls altogether 
and implementing Algorithm II. 

SUMMARY 

In this article, we discussed the 
problem of mutual exclusion 
while accessing a shared file using 
NFS on OS/2 and presented a 
simple algorithm for solving the 


problem. The algorithm works 
fine when process and node fail¬ 
ures are not a concern. It turns out 
that the problem of coping with 
failures is not easy due to the 
inherent asynchrony in distrib¬ 
uted systems. We presented step- 
by-step improvements to the sim¬ 
ple algorithm, which gradually 
increase the algorithm's reliability. 
Finally, we presented a C imple¬ 
mentation of Algorithm III which 


subsumes all of the algorithms 
discussed in the article. 
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Using the LAN Net View 
Basic User Interface APIs 


ow that you've learned how to 
communicate between manag¬ 
ing and managed stations (see 
"'Introduction to LAN Net View 
Application Development: An XMP/ 
XOM Primer/' November/December 
1993), it's time to learn how to inte¬ 
grate your managing application with 
the LAN NetView program's View 
user interface component. The View 
component allows the system adminis¬ 
trator to navigate through the network 
topology using an object-oriented, 
workplace shell-like interface. 

In addition, you can integrate 
managing applications on the View 
component's topology display, which 
enables them to share the displayed 
objects. This allows the system admin¬ 
istrator to navigate to the object of 
interest and select the application 
action to be performed against it in the 
same manner, no matter how many 
applications are integrated with the 
topology display. 

The View component relieves the 
application programmer from the bur¬ 
den of supplying the navigation logic. It 
also allows the management program to 
retrieve topology and user interface 
information from common databases 
using OS/2's System Object Model 
(SOM). 


THE TOPOLOGY/DISCOVERYSERVICE 

Before you can learn how to integrate a 
managing application with the View 
topology display, you must understand 
how the system administrator uses it. 
The View display reflects the contents of 
the LAN NetView platform's discovery 
database. The discovery database con¬ 
tains information that LAN NetView dis¬ 
covery processes have discovered about 
the resources in the network. This infor¬ 
mation is arranged in three hierarchical 
levels. 

The top level object is the physical 
system that represents a managed sta¬ 
tion. Either the media access control 
(MAC) address of the primary commu¬ 
nication adaptor or an Internet protocol 
(IP) address names the physical system 
in the discovery database. 

Physical systems contain the next 
level objects called logical systems. A 
logical system is a view of the physical 
system as seen by a management 
agent. For example, the LAN NetView 
program's system agent implements an 
International Standards Organization 
(ISO) system object that provides a 
Common Management Information 
Protocol (CMIP) view of the system. A 
Simple Network Management Protocol 
(SNMP) agent sees the system as an IP 
address with an SNMP system group. 
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A Novell NetWare agent sees a 
system differently from either an 
SNMP agent or a CMIP agent. 
Each of these views appears as a 
logical system in the LAN 
NeiView platform's discovery 
database. All three of them could 
be present in the same physical 
system. 

Logical systems contain third- 
level objects known as resources. 
The discovery database does not 
contain information on all the 
resources on the managed stations. 
For CMIP logical systems, the 
database contains all of the infor¬ 
mation on each object that is 
named under the ISO system 
object in the naming tree, is no 
more than one level below the sys¬ 
tem object, and contains state or 
status attributes. 

For SNMP logical systems, it 
contains the information from the 
SNMP system group. Only three 
levels of objects—physical sys¬ 


tems, logical systems, and 
resources-—and their associated 
attributes are contained in the dis¬ 
covery database and presented to 
the system administrator in the 
View topology display. 

USER INTERFACE MODEL 

Using the View component's user 
interface, the system administra¬ 
tor sees the topology display as 
nested container objects similar to 
the OS/2 workplace shell direc¬ 
tory tree. 

The top-level container is the 
management collection, A man¬ 
agement collection is simply a set 
of systems that the system admin¬ 
istrator has grouped together 
because they share something in 
common. 

For example, the systems may 
all be in one building, or they 
may all contain LAN NetView 
agents for IBM's LAN Server. 
When the system administrator 


opens a management collection, 
its contents are displayed. The 
contents of a management collec¬ 
tion are systems. 

In this context, systems are 
shadows of the physical systems 
contained in the discovery data¬ 
base, This is due to the fact that a 
given physical system may be 
contained in multiple manage¬ 
ment collections. The contents of 
a system container are resources. 
Both logical systems and discov¬ 
ery-database resources appear as 
resources in the View resource 
display. 

PROGRAMMING CONCEPTS 

Like the OS/2 workplace shell, 
the View component of the LAN 
NetView program was developed 
using object-oriented program¬ 
ming and OS/2's System Object 
Model, Your management appli¬ 
cation program must also be 
developed using object-oriented 



Figure 1 . Hierarchy diagram 


30 


OS/2 DEVELOP EH 







































* 


W- 


. ti today s high technology marketplace, you hear a lot of stories about proprietary 4GLs for client/server 
application development. Stories that lure you... that make 4GLs sound flexible, fast and open. 

Beware the paradox: how can 4GLs be open when someone else holds the key? 
Using client/server 4GL tools means opening Pandora s box of proprietary languages, vendor lock in, and runtimes up lo 16 
times slower With surprises like these, trusting your business-critical applications to 4GLs should scare you half lo death. 


ith KA5E:V1P, you get client/server solutions in standard languages like C, 
C++ and COBOL. Safe, secure solutions that leverage your current investment instead 
of replacing it. Using interactive visual design and code generation technology, 

KASE:VIP delivers the rapid development and increased productivity 
promised by 4GLs— but without unpleasant surprises. 


Don’t open Pandora’s box. Get the facts in our free white paper, 

“No Strings, Boxes, or Borrowed Time: Overcoming 4GL 
Dependencies with Standard Language Client/Server 
Development Tools.” 

KASE WORKS' 

£>■ Enabling Client/Server Strategies 

The leader in standard language-based client /server took. 


for OS^2 


Just call 1 (800) 888-4335 or (404) 448-4240* 


Fact. Not fantasy. 


Circle Reader Service Number 17 








m 


HyHenuIteml(pHier,pHodel,p*ppParm,p$elected) 

Initialize variables and get the system record handle; 
Get the icon title text; 

Check for the presence of an SNMP agent; 

Check for the presence of a CHIP OS/2 agent; 

Show the user which agents exist and call the 

XMP interface program to display data if requested, 
Cleanup buffers; 

} // end MyMenuIteml 


programming and SOM. While 
this article is not intended to 
teach you object-oriented pro¬ 
gramming, it is useful to define a 
few terms as we will use them 
here; 

* Classes are the definitions of 
program objects in terms of the 
data they contain and the pro¬ 
gram logic that operates on the 
data, 

* Objects are particular instances 
of some class. An object has 
unique values assigned to the 
data items defined in the class. 
Assume, for example, that 
Mydass defines a data item called 
Color. The value of Color in 
instance A of MyClass might be Red, 
while the value of Color in 
instance B of HyClass might be 
Blue. 

* Methods are simply procedures 
defined in the class that perform 
actions, usually associated with 
the data items, 

A class. A, may be defined in 
such a way that it inherits proper¬ 
ties of another class, B. This is 
known as subclassing. We say that 
class A is a subclass or child class of 
B, and B is the parent class of A. 

When a class A is a subclass of 
class B, it inherits all the proper¬ 
ties of the parent class. If class A 
must have some different proper¬ 
ties than B, it can implement them 
by adding methods to those 
inherited from the parent class or 
by changing the methods it has 
inherited. This latter process is 
known as overriding a method 
from the parent class. 

The process of subclassing par¬ 
ent classes and overriding their 
methods soon results in a hierar¬ 
chy of classes, which is known as 
the class hierarchy. 

PROGRAMMING MODEL 

In the View component's object- 
oriented programming model, 
the View container objects {that 
is, management collections, sys- 
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Figure 2. Sample application pseudocode 

terns, and resources), are mod¬ 
eled as program objects. These 
objects, usually called associated 
objects, implement methods that 
may be called by your manage¬ 
ment application program to act 
on the data contained in them. 

Management application pro¬ 
grams are also program objects in 
the View model. You implement 
your management application 
program by developing an appli¬ 
cation program class that con¬ 
tains methods that the View com¬ 
ponent's associated objects may 
call. You use SOM to define the 
class that describes your applica¬ 
tion object and then use C to add 
logic to the methods in your 
management application pro¬ 
gram class. 

To make it easier for you to 
develop your management appli¬ 
cation program in this manner, 
the View class hierarchy contains 
a stub application class you can 
subclass to create your applica¬ 
tion program. This class is the 
DLSApp class in the View class hier¬ 
archy diagram illustrated in 
Figure 1. 

In addition to the associated 
object classes and the application 
stub class. View classes also sup¬ 
ply an object to access the discov¬ 
ery database information and 
access and update the user inter¬ 
face information stored in the 
View user interface database. 
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DEVELOPING AN 
APPLICATION CLASS 

The process of developing an 
application class consists of five 
steps: 

* Create a SOM class definition 
(.CSC) file. This is a source file that 
specifies the parent of your appli¬ 
cations class, the class name, new 
or overridden methods, and any 
data items that instances of your 
class own. 

* Compile the .CSC file using the 
SOM compiler SC.EXE, This step 
produces a skeleton ,C file that 
contains your class definition 
and a function declaration for 
each method that is introduced 
or overridden in your class. It 
also produces several include 
files. 

* Use the C compiler and OS/2 
linker to create a dynamic link 
library (DLL) containing your 
class. 

* Use the resource compiler RC.EXE 
to add any necessary Presentafion 
Manager resources to your DLL. 

* Use the View component's regis¬ 
tration command LNVREG to regis¬ 
ter your class with the View reg¬ 
istration services. 

That's all there is to it. To show 
how easy it is, let's develop a View- 
based front end for the X/Open 
Management Protocol (XMP) appli¬ 
cation we introduced in the last arti¬ 
cle, "Introduction to LAN NetView 
Application Development: An 
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XMP/XOM Primer," November/ 
December 1993. 

Our XMP program used the 
IP address for SNMP agents or 
the distinguished name for CMIP 
agents to access the agent to 
retrieve or modify data. We used 
a hand-built file containing the IP 
addresses and distinguished 
names, which we needed to 
address the agents. In this exam¬ 
ple, we obtain that information 
from the View services and let the 
View display provide the func¬ 
tions necessary to select the sys¬ 
tem of interest. 

The overall flow will work like 

this: 

* The LAN NetView discovery 
services will discover systems 
and resources in our network 
and save the information in the 
discovery database, 

* The View user interface ser¬ 
vices will display the network 
topology and allow the system 
administrator to select a sys¬ 
tem. The View services will 
also allow the user to select our 
program from a popup menu 
associated with the selected 
system. 

* When the user selects our menu, 
the View services will create an 
mstance of our application class, 
called an application object, that 
is associated with the selected 
system. Then, it will call a menu 
^method in our application 

• When our menu item method 
receives control, it will use View 
services to access the discovery 
database object to obtain a 
record handle for the system. We 

will use this item later to retrieve 

nfomtauon from , he discovery 

Next, our method will use the 
^ component's user interface 
database services to obtain the 
•con text for the selected system. I 

then, it will use View ser¬ 
vices to access the discovery data- 




-- dsmsampl.csc 
include <duiapobj,sc> 
class: DSMSampl* 
global; 

parent: DLSApp; 

passthru: Ch, before; 
Idefine INCLJJIN 
Idefine XNCLJASE 
Idefine BCL.ERRGRS 
Idefine INCL.OOSPROCESS 
lindude <os2,h> 
lindude <string,h> 
lindude <stdio.h> 
lindude <dsmdef.h> 
lindude <duicmudt,h> 
lindude <dsmcmtmd*h> 
lindude "dsmsmpOl.h 11 
lindude "dmoh.h" 
endpassthru; 

data: 

HMODULE HodHandle; 
methods: 


int MyMenuIteml(STRING_KRRAY_OBJ tpHier, 

SQMny *pModel 3 
PVOID pAppParm, 

SOWAny *p$dected); 

ULDNf^MTPfi 6 %cn 0r SNHP infor ™ ati( >" from a selected system 
ULQNGCHIPReq(REQU£STSTUFF * P CHIPReqParms)- > 

This method handles the displays fnr th 

•• *«- -« ® zi: 

- there is an sump !! *V for the case “here 
"* 15/2 " * gm - 

„ RE ^KTSTUFF ♦pSNHPReqParmsj; 

This method handles the Hienis x 
~~ there is both an SNMP S j S ° r the Case where 
override s «°°“ ^ an, agent . 

” Instance setup 


Figures. Sample .CSC file 
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base to determine if an SNMP 
agent or a LAN NetView system 
agent exists on the system. Our 
program will display an appro¬ 
priate menu depending on 
whether it finds one, both, or 
none of these items. If the user 
decides to retrieve SNMP or 
CMIP information from the sys¬ 
tem, our program will call the 
XMP sample program to retrieve 
the data. Finally, the method will 
display the results of the XMP 
operations. Figure 2 shows the 
pseudocode for this function. 

The first step in our sample 
program development is to 
design the PM screens and create 
the resources. WeTl assume here 
that this step has already been 
done, so we will move on to cre¬ 
ating our .CSC file, shown in 
Figure 3. 

CREATING THE.CSC FILE 

The parent class of our applica¬ 
tion class will be DLSApp, so we 
must specify that in our .CSC file. 
We must also include the SOM 
language-independent definition 
of DLSApp, which is in the 
OUIAPOBJ .SC file. We will introduce 
one new menu item method, 
MyHenuIteml, so we must specify 
that in our .CSC file also. Our .CSC 
file also includes an override of 
the somlnit method and three 
other new methods that are used 
to present the PM screens for our 
program. 

Another thing we can specify 
in the .CSC is information that we 
want SOM to pass to the include 
files it generates. This informa¬ 
tion is in the passthru section. In 
our .CSC, we have told SOM to 
pass through includes for some 
standard .H files and two -H files 
that contain the definitions of our 
private data structures, PM defin¬ 
itions, and so on. 

Since menu item methods 
must conform to a specific syntax, 
the prototype for a menu item is 



SOMJkope int SOMLINK MyMenuIteml(DSMSampl *somSelf, 
STRINGJRRAY.OBJ *pHier, 

SOMAny *pModeI, 

PVOID pAppParm, 

SQMAny *pSelected) 


ULDNG 

ulRC; 

// Return code 

char 

♦Names[10]; 

// Name pointer array 

PSZ 

IconText; 

// Icon text 

PSZ 

SystemName; 

// Displayable system name 

DLSUIData 

♦pUIDB; 

// UI DB pointer 

UIDATA.KEYS 

Keys; 

// UI database key struct 

yiDATJLlNFO 

Unnfo; 

// UI info struct 

DSMTHData 

*pTDB; 

// Topology DB pointer 

char 

**LongNames; 

// Long name array 

HTOBRECS 

♦pHandles; 

// Handle array ptr 

HTDBREC 

♦pThisSys; 

// System handle pointer 

TMDJTTRS 

*pAttributes; 

// Attribute array pointer 

TMDJTTR 

♦pAttr; 

// Attribute pointer 

TDBENTS 

♦pResources; 

// Resource array pointer 

PSZ 

AttrValue; 

// Attribute value 

PSZ 

IPAddr; 

// SNMP IP address 

int 

ResourceCount; 

// Number of resources 

pTOP.DN 

SysObjectDN; 

// CMIP sys obj DN 

TOP.DN.BUF 

♦pDNArray; 

// From HueryDN 

NAB 

hab; 

// PM Anchor block handle 

HMQ 

hffiq; 

// PM Message queue handle 

REQUESTSTUFF 

CMIPReqParms; 

// CMIP request parameters 

REQUESTSTUFF 

SNMPReqParms; 

// SNMP request parameters 


Figure 4 . Method declaration and variables 


included in the DUIAPGBJ.3C file. 
This prototype does not represent 
a real method and is not intended 
to be overridden. 

Let's take a look at the para¬ 
meter list of our menu item 
method. The first parameter of 
any SOM method call is a pointer 
to the object receiving the call. 
This is never specified in a .CSC 
file, however, so we have not 
specified it here. The first para¬ 
meter in our method prototype is 
pHier. It is defined as a pointer to 
a STRING^ARRA¥_0BJ structure. This 
structure contains the string rep¬ 
resentation of the View class and 
instance names of the associated 
object that called the menu item 
method, STRING,ARRAY,QBJ struc¬ 


tures are used extensively in 
View methods. They contain a 
pointer to Array, which is an array 
of pointers to null-terminated 
strings, and an integer field. 
Count, which is the number of 
string pointers in the array. You 
refer to the class name of the 
associated object, which is the 
first string in the $TRXNG_ARRAY_OBJ 
pointed to by pHier, like this: 

MyStringPointer = pHier->Array[0]; 

The second parameter, pModel, 
is a pointer to the associated 
object itself. This is the object 
whose class and instance 
names are contained in the 
STRING_ARRAY_OBJ structure. 
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Figure 5Initialize and retrieve system record handle 


The third parameter is a 
pointer to a data item you can 
specify at the time the View regis¬ 
tration service registers the menu 
item method. Although this item 
is defined as a pointer to void, the 
registration service only allows 
strings to be registered. This item 
is useful, if you use the same 
method for several menu items. 
You can use the registration para¬ 
meter with a switch statement to 
determine the context of the 
method call. 

The last parameter, ^Selected, 
is a pointer to a View object that 
contains the list of selected items 
for the associated object* 

After we execute the SOM 
compiler SC TIE against our .CSC 
file, we will have a skeleton X 
file that contains a function decla- 
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ration for our menu item method. 
The next step is to use C to add 
logic to our .C file. Figure 4 
shows the method declaration for 
HyHenuIteml and the variables used 
by the method. 


RETRIEVING THE 
SYSTEM RECORD HANDLE 

Figure 5 shows the first block of 
code in our method. This code 
initializes some variables that we 
will test later in the program and 
accesses the discovery database to 
retrieve the system record handle* 
Record handles are the discovery 
database object's private keys. 

To retrieve information from 
the discovery database, we use 
the discovery database class 
DSMTMData* This class has a single 
instance allocated by the View 
services at initialization time. 
This instance must be used for all 
calls to the class* We can use the 
SOM get_ macro to retrieve its 
address, as shown in the example. 
The methods in the DSMTMData class 
use some special structures that 
are defined in the DSMCWTHD. H file 
shipped with the LAN Net View 
product. 

The discovery database object 
retrieves information regarding 
physical systems and resources 
and their respective attributes. In 
this context, discovery database 
logical systems are considered 
resources. To get the record han¬ 
dle for our system, we must call 
the DSMTHData class's GetTDBHandles 
method. The input to this method 
is an array of long names and an 
integer that indicates the number 
of elements in the array 

The return information is a 
pointer to an array of record han¬ 
dles, one for each long name in 
the input array. If any long name 
does not have a corresponding 
record handle, the handle for that 
position in the output array will 
be set to NULL. In our case, we will 
pass an array with one element: 


Get user interface database pointer 


// Get class name 

// Get instance (long) name 

// Set data type to icon title 


// 

// 

// 

pUIDB = get^pUDT(_DLSUIData); 

// 

// Set up user interface database interface structure 

// 

UIInfo.UIDataKeys = feKeys; // Set key struct address 

// 

// Set pp 'key structure 

't 

Keys,Class = pHiern>Arrs^ [0]; 

Keys* Name = pHier*>Wrray[J|^ 

Keys.Datatype - DTK PE jTTtl'!:; 

Keys.Subtypel - (PYQID) KEY_TERM; // Set terminator 

// 

// Call UI database method 

// 

IconText - .QueryDatafpUIDBj&UIInfo); 
if (IconText != (P5Z) NULL) { 

// 

// We have icon text so save it in a private buffer 

// 

SystemName = (PSZ) _ATLocBuffer(somSelf a strlen(IconText) + 1); 
st r cpy(Sy st emNa me , IconText); 

} else { 

// 

// Call discovery database for short name if no icon text 

// 

pAttributes = 

_QueryAttribute(pTDB,pTfois$ys,1^0,ATTIT5NAHE,(char *) NULL); 
if (pAttributes != NULL) { 

// 

// Extract short name and save it 

// 

pAttr = ft(*pAttributes)[0]; // Get attribute struc pointer 
IconText = (PSZ) pAttr“>valueList; // Get attribute address 
SystemName = (PSZ) ,AlIocBuffer(somSelf,strlen(IconText) + 1); 
strcpy(SystemName,IconText); 

} else { 

// 

// No short name? Just use long name 

// 

SystemName - 

(PSZ) JllocBuffer(somSelf,strlen(pHier->Array[1])); 
strcpy(Sy stemName,pHie r->A r ra y[1]); 

} /* endif */ 

// 

// Free attribute array buffer 

// 

_FreeBuffer(pTDB,(char *) pAttributes}; 

} /* endif */ 


Figure 6. Retrieving the icon text 
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the second element of the array 
pointed to by pHier. 

RETRIEVING THE ICON TEXT 

Our program's next task is to 
determine the text that is dis¬ 
played under the icon for our 
associated system object. Figure 6 
shows the code block for this. The 
icon text is normally an attribute 
of the system object called the 
short name. The short name 
attribute is stored in the discov¬ 
ery database. However, the sys¬ 
tem administrator can change the 
text that appears under the icon. 
If this occurs, the name of the sys¬ 
tem doesn't change, but the text 
entered by the system administra¬ 
tor is displayed under the icon 
and saved in the View user inter¬ 
face database. To determine the 
name displayed under the icon. 


we must first check the user inter¬ 
face database to see if the system 
administrator has changed the 
text. If the text has not been 
changed, we must retrieve the 
short name from the discovery 
database, 

We will use the QueryData 
method of the user interface data¬ 
base class DLSUIData to retrieve the 
icon text. Before we call the 
QueryData method, however, we 
must obtain the address of an 
instance of DLSUIData. As in the 
case of the discovery database 
class, the View services create an 
instance of DLSUIData when it is 
first initialized. Only this one 
instance should be used to inter¬ 
face with the user interface data¬ 
base. We can obtain its address 
with the SOM get_ macro, as 
shown in the example. 


To retrieve data from the user 
interface database, we must first 
fill in a UIDATA^KEYS structure with 
a key that will access the data. 
Data in the user interface data¬ 
base is located by a compound 
key with six fields: 

• Class is the name of the View class 
for the object that owns the data. 
In our case, it is the name of the 
View System class passed as the 
first array element pointed to by 
pHier. 

• Name is the View instance name, 
commonly known as the long 
name. Our system's long name 
is the second array element 
pHier points to. 

• Datatype is one of the data types 
defined in the DSMDEF.H file. The 
data type for icon text is 
DTYPEJITLE. 



• Siihtypel is an unused qualifier. 
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* Subtype2 is an unused qualifier. 

* Subtype3 is an unused qualifier. 

The first unused field in our 
example, Subtypel, must be set to 
the constant, KEY.TERM, which is 
defined in DSMDEF.H. We must 
build the key in a UID AT A _ KE Y S 
structure, which our class pro¬ 
vides. In addition, we must store 
the address of the UIDATA.KEYS 
structure in the UIDataKeys field of 
a UIDATA.INFO structure, which our 
class provides. This structure will 
be input to the QueryOata method 
of the user interface database 
class DLSUIData, 

If QueryData returns a value 
other than NULL, the system 
administrator has assigned a cus¬ 
tom label to this icon, and we can 
save that to use as the displayable 
system name. If a NULL pointer is 
returned, however, then the short 
name is the name under the icon, 
so we must retrieve it from the 
discovery database. 

The short name is an attribute 
of a system or resource, so we 
will need to call the discovery 
database object's Query Attribute 
method. This method, like most 
methods in the DSMTMData class, 
requires a record handle as input. 

We can use the record handle 
we retrieved during initialization 
when we issue the Query Attribute 
method call to retrieve the short 
name. In addition to a record han¬ 
dle, this method requires either 
an integer attribute identifier or a 
string that is the dotted ASCII 
representation of the object iden¬ 
tifier for a CMIP attribute. 

The short name is one of the 
attributes defined in DSMCMTMD.H, so 
we can pass the integer attribute 
identifier. If the attribute does not 
exist, then Query Attribute will 
return NULL. If it does exist, the 
method returns a pointer to an 
array of TMD_ATTR structures, each 
of which contains a pointer to the 
iist of values of the attribute and 
an integer that specifies the num- 


// 

// Call discovery database for SNMP SYSOESCRIPTION MIG variable 
// 

pAttributes = 

_QueryAttribute(pTOB,pThisSysJHD_ATTR_SNHPSYSOESC,(char *) NULL); 
if (pAttributes != NULL) { 

// 

// Free attribute array buffer 
// 

JTeeBufferfpTDB,(char *) pAttributes); 

// 

// We have an SNMP agent so get the IP address 
It 

pAttributes = 

.QueryAttributeCpTDBjpThisSysJMD^ATTR^IPAODRS,(char *) NULL); 
pAttr = &(*pAttributes)[0]; // Get attribute struc pointer 
AttrValue = (PSZ) pAttr->valueList; // Extract IP address 
IPAddr = (PSZ) _AllocBuffer(somSelf,strlen(AttrValue) + 1); 
strcpytIPAddr,AttrValue); // Save IP address 
// 

// Build the parameter structure for the PM and XSMP calls 
// 

SNMPReqParms. SystemNaine - SystemName; 

strepy(SNMPReqParms.NostName.SNMPName.IPAddress JPAddr); 

strepy(SNMPReqParms.HostName.SNMPName.CommunityName,"PUBLIC"); 

} /* endif */ 

// 

// Free attribute buffer 
// 

^FreeBuffer(pTDB J (char *) pAttributes}; 


Figure 7. Determining the presence of an SNMP agent 


her of attribute values in the list. 
The short name is a simple 
attribute with only one value, so 
there is only one element in the 
array and only one value in the 
list* 

Since most applications need 
to retrieve the short name of a 
system object, the LAN NetView 
product provides an API, called 
GetShortName, that contains the 
logic we have just developed. 

DETERMINING THE 
PRESENCE OF A GENTS 

The last task we must perform 
before we display our first screen 


is to determine if SNMP or LAN 
NetView agents exist on the sys¬ 
tem. We can use the DSMTMData's 
Query Attribute method to perform 
part of this task also. Figure 7 
illustrates the block of code that 
determines if an SNMP agent 
exists. 

To determine if an SNMP 
agent exists on the system and 
retrieve the IP address necessary to 
communicate with the agent, we 
can use DSMTMData's QueryAttribute 
method to retrieve the value of the 
TMQJTTR.SNMPSYSDESC attribute. We 
can use the same record handle 
we retrieved in the initialization 
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routine* If this request returns a 
NULL pointer, no SNMP agent exists 
on the system* If the request is suc¬ 
cessful, we will know there is an 
SNMP agent, so we can use the 
QueryJlttribute method again, this 
time to retrieve the IP address. 

To check for a LAN NetView 
OS/2 agent and retrieve the 
necessary addressing informa¬ 
tion, we will use two new meth¬ 
ods* Again, we will use the 
DSHTHData class and the system 
record handle from our initializa¬ 
tion routine* Figure 8 illustrates 
the block of code that performs 
this function. 

The first thing we must do is 
test for the presence of a LAN 
NetView OS/2 agent. This object 
is a resource. To test for its pres¬ 
ence, we must use the DSHTHData 
class's QueryResources method* We 
can use this method to return a 
list of all the resources on a sys¬ 
tem; however, we will use it to 
test for the presence of a single 
resource. 

As the example shows, the 
input to this method is a system 
record handle, the address of an 
integer field where DSHTHData can 
put the count of resources 
returned and a pointer to a char¬ 
acter string representing the 
resource ID. If this last parameter 
is NULL, then all of the resources 
will be returned. If it is set to the 
string form of a CMIP object iden¬ 
tifier, then only the data pertain¬ 
ing to that resource will be 
returned. If the resource doesn't 
exist, then a NULL is returned. The 
object identifiers for some of the 
more common resources are 
defined in DSHDEF.H. We will pass 
the object identifier for the DS2 
object that is the top-level object 
in the LAN NetView OS/2 agent. 

If our QueryResources call is 
successful, we will know that an 
OS/2 agent exists on the machine, 
but we will not know the address 
of the OS/2 object. To retrieve 



Figure 8 1 Determining the existence of a CMIP OS/2 agent 



Figure 9, Cleanup 
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this we must use the QueryDN 
method. This method requires a 
record handle as input and 
returns an X/Open Abstract Data 
Manipulation (XOM) encoded 
object, which is the distinguished 
name of the object associated 
with the record handle. If the 
record handle represents a sys¬ 
tem, then the method requires a 
second parameter to identify 
which logical system's distin¬ 
guished name should be 
returned. We could ask for the 
distinguished name of the OS/2 
object, since its record handle was 
returned in the previous 
QueryResources call. To allow our 
program to work better with our 
XMP example, however, we will 
ask for the distinguished name of 
the LAN NetView system object. 
To do that we must pass TMD_D5M as 
the system ID. The return is an 
array of distinguished name 
objects. In our case there is only 
one object in the array. 


TERMINATION 

The last thing our method must do 
is to deallocate any buffers that it 
has allocated or that the View 
objects have returned. Figure 9 
shows this function. 


REGISTERING AN 
APPLICATION CLASS 

We are finished with the develop¬ 
ment of our menu item method. 
One more step remains before we 
can call it from the View compo¬ 
nent's topology display We must 
create a registration file to regis¬ 
ter our class and menu item 
method with the View registra¬ 
tion service. 

The View registration file 
uses a simple tag language. 
Although there are many tags, we 
need only two for our registration 
file shown in Figure 10. We use 
the APPLICATION tag to register our 
application class; and we use the 
ASS0FUNCTIONITEM tag to register the 



Figure 10 Registration file 


menu item method. 

The syntax of all tags in the 
registration file is: 

<tag keyword-value ... key wo rd=v alue> 

There must be no spaces 
between the equal sign and either 
the keyword or the value. 

The keywords for the APPLICA¬ 
TION tag in our example have the 
following meanings: 

* CLASS is the name of our applica¬ 
tion class. 

• HODULENAME is the name of the .OIL 
file that contains our class. 

• GLGBALINSTANCE is the keyword 
that tells the View run-time ser¬ 
vices whether the application 
class can be instantiated more 
than once. The N means that 
our class can have as many 
instances as needed. A Y here 
means that our class works like 
a monolithic application and 
can only have one instance. 

* NAME is the full name of our 
application. 


* SHORTNAME is a short name for our 
application. 

* HELPFILE is the name of a help 
file that contains help informa¬ 
tion used when the user selects 
the help function when one of 
our menu items is selected. 

The keywords on the ASSOFUNC- 

nONITEM tag have these meanings: 

* TEXT is the text that appears on 
the menu. 

* CLASS is the class to which this 
menu item belongs. 

* ACCEL is a character in the menu 
item text that can be used to 
select our item from the key¬ 
board, 

* METHOD lists the name of our 
method. 

* INFOTEXT contains the text that 
appears at the bottom of the 
window when our menu item is 
selected. 

* HELPH) is the ID of the item in the 
helpfile that pertains to our 
menu item. 

* ID is an identifier for our menu 
item. If we had a cascaded menu. 
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we could use this identifier as an 
anchor for it. The View menu 
processing functions will ensure 
that there are no collisions 
between our menu item IDs and 
those of other applications. 

• PARENTID is the menu ID of the 
menu that will contain our 
menu item. This ID must be 
one of our own or one of those 
listed in the DSMDEF.H file. We 
have specified that our menu 
item will appear on the 
Application Action menu. 

* ASSOCIATE is the keyword that 
tells the registration service 
which classes of View objects 
should be associated with our 
menu item. We have specified 
that System objects should be 
associated with MyMenuIteml. 

We can register our class and 
menu item by processing our reg¬ 
istration file with the LNYREG com¬ 
mand like this: 

LNVREG dsfnsampl.reg 

That's all there is to it. Our 
application is integrated with the 
LAN NetView topology display. 
The system administrator can use 
the View functions to navigate to 
the system of interest and execute 
our application. The only user 
interface code we had to write 
was the code that displays a sim¬ 
ple dialogue and the information 
returned by our XMP application. 

Chuck McKelley, IBM LAN Systems , 
Austin Programming Center, Austin, Tex., 
is an advisory programmer on the LAN 
NetView Vendor Support team, in his 26 
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technical and management positions in 
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He received a B.S. in electrical engineer¬ 


ing from Northwestern University in 
1974 and an M S. in computer science 
and control systems from the University 
of Minnesota in 1977. Rzepka has also 
completed post-graduate studies in the 
information systems and electrical engi¬ 
neering departments at the University of 
Texas in Austin. 
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in this article, we will develop and debug a management system that uses the LAN NetView network 
management platform. The remote agents that will be a part of our management system will use the 
industry standard SNMP. By STACEY TAYLOR 

Network Management: 
Using SNMP for LAN 
NetView 



Stacey Taylor 


II ave you ever had a problem 
with your workstation's net- 
m m work connection? How did 
you solve the problem? Did you use a 
protocol analyzer? 

Generally, a protocol analyzer is 
overkill for most network problems. 
Alternates to protocol analyzers are the 
relatively new network management 
systems. IBM's LAN NetView is one of 
these systems. 

In this article, we will develop and 
debug a management system that uses 
the LAN NetView network manage¬ 
ment platform. The remote agents that 
will be a part of our management sys¬ 
tem will use the industry standard 
Simple Network Management Protocol 
(SNMP), 


FOR A FEW DOLLARS MORE (OR LESS) 

In a standard distributed network man¬ 
agement system, there are a managing 
workstation and several managed work¬ 
stations. The managing station requires 
one of several network management 
platforms: HP's OpenView, IBM's 
NetView/6GQ0, IBM's LAN NetView, and 
SunNet Manager. 

In choosing the most appropriate 
platform, my company. Network Telesis 
Inc. (NT1), decided to port its LAN/WAN 
Response Time Monitoring system to the 


LAN NetView platform because it is 
based on an industry standard (XOM, 
XMP, and X.400), supports OS/2 
Presentation Manager, and provides the 
best user cost/benefit ratio. 

Generally available with most 
TCP/IP products, SNMP agents collect 
a wide array of information about the 
workstation they are running on. Over 
175 items are in the SNMP information 
base, including the workstation's 
owner, the speed of interface card, and 
the number of bytes received and sent 
by the card. 

But if the remote workstation is on 
Mars, the information is useless— 
unless you can extract this information 
to your local workstation. By using 
IBM's LAN NetView and the program 
provided here, you will be able to 
interrogate any SNMP agent. 

The development and operating 
environment is shown in Figure 1, 

The only module of LAN NetView 
that is used is the Manage module. For 
the remote managed stations, you can 
use any SNMP-compliant agent run¬ 
ning over TCP/IP An SNMP agent is 
required to support a predetermined 
set of data (which is referred to as MIB~ 
XI and defined in RFC 1213, available 
on the Internet). 

To send a request to the SNMP 
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MANAGING STATION 


MANAGED STATION 



PSZ95 

32MB Memory 
4QDMB Hard Disk 
16MB T/R Card 


336 Done 
4MB Memory 
210MB Hard Disk 
16MB T/R Card 


SOFTWARE 

CS/2 2.1 

IBM's TCP/IP v 1.2 
LAN NetView 'Manage' 


SOFTWARE 

DOS 5.0 

IBM’s TCP/IP v 2.1 
SNMPD(TSR) 


SNMP Variable Settings: 

Syscontact: Inspector Harry Callihan 
Syslocation: San Francisco Police 


Figure 1 . Development environment 


agent, LAN NetView requires us to 
follow a special format when con¬ 
structing the request. The format is 
defined by the X/Open XMP specifi¬ 
cation and is shown in Figure 2. 


THE UNFORGtVBN 

Our program will read these four MIS-II 
variables from the SNMP agent: sys¬ 
tem contact system name, system loca¬ 
tion, and number of bytes received by 


SNMP Get Request 


Title 

Data Type 

Occurences [ 

Header 1 

header ID 

t 

TCP/IP Address 

pointer to Network Address 

1 

Access Control 

pointer to Community Name 

1 

Variable IDs 

MP VAR ID L1ST 

MIB -II IDs 

1 or more 

Network Address 




Title 

Data Type 

Occurences [/j 


'Header' 

header ID 

1 A 


TCP/IP Address 

binary string 

' P 


Community Name 




' Title 

Data Type 

Occurences / 

*- 

'Header' 

header ID 

1 H 


Community Name 

text string 




Figure Z Formatting Instructions for SNMP Get 


MARCH/APRIL 19 9 4 






































1 OM.CLASS DH_S_OBJECT_IDENnFIER, STRING HP C^SNMP^GET.ARGUMENT 

2 MP.RESPONDER.IPJDDRESS QK.S.OBJECT 2006C 

3 OM.CLASS DM.S.OBJECT.IDENTIFIER.STRING HP_C_NETWORK_ADDRESS 

4 HP.IP.ADDRESS OM-S OCTET.STRING 198.202.254.1 

5 MP.VAR.ID.LIST OM.S.OBJECT.IDENTIFIER.STRING 1.3.6.1.2.1.1.4.0 

6 MP.VAR_IO.LIST DM.S.OBJECT.IDENTIFIER.STRING 1.3,6.1.2.1.2.2,1.10.1 

7 Error in determining type! GM.S.OBJECT.IDENnFIER.STRING 1.3.6.1.2.1.1.5.0 

8 MP.VAR_ID.LIST OM.S.OBJECT.IDENTIFIER.STRING 1.3.6.1.2.1.1.60 

9 MP.ACCESS.CONTRDL OM.S.OBJECT 20090 

10 OM.CUSS OM.S.OBJECT.IDENTIFIER.STRING MP.C.COMMUNITY .NAME 

11 HP.COHMUNITY OM.S.OCTET.STRING public 


SNMP Response 


/ 

Title 

Data Type 

Occurences 

1 

"Header 1 

header ID 



Variable Bind list 

Pointer to Var Bind List 

’ 1 

f 


Vat Bind List 




Title 

Data Type 

Occurences 

'Header 1 

header ID 

1 

Name 

String 

1 

Value 

Pointer to Object Syntax 

i 



Object Syntax 



Title 

Data Type 

Occurences 

"Header 1 

header ID 

i ."1 

Simple Type 

Pointer to Simple Type 

1 I 

Application Type 

Pointer to Application Type 

i - - 1 


t 


Simple Type 


/ -ntfrirfTW rtWi 


Title 

Data Type 

Occurences 

'Header* 

header ID 

’„ 1 

Number 

Integer 


String 

String 

1 \ 

Object 

String 

i 


Application Type 



a 

Title 

Data Type 

Occurences 

'Header 1 

header ID 


H 

Address 

pointer to Network Address 



Counter 

Integer 

j .... 


Gauge 

Integer 

j 1 

t 


Figure 4 * X/Open format for SNMP responses 


the network interface card* 

Once you understand the 
somewhat obtuse X/Open com¬ 
munications structure, program¬ 
ming within this environment is 
relatively easy. The difficult part is 
debugging a problem in the 
X/Open structure. A timesaving 
hint in debugging is to code and 
test the communications modules 
under OS/2 character mode. 
Simply starting LAN NetView's 
GUI (called View) is a very slow 
process, and it must be terminated 
before every compile! After the 
basic communications testing 
passes in-house testing, the code 
can be converted to run under the 
SOM-based View. 

Our programming example 
concentrates on the debugging 
aspects of SNMP communications. 
This program contains a malformed 
SNMP Get request. To assist us in 
determining where the error is, a 
routine was developed to convert 
the SNMP request into a format for 
easy examination. The routine is 
called just before the LAN NetView 
communications instruction and 
just after the return from LAN 
NetView* Figure 3 shows the output 
from our debugging routine* 

The LAN NetView error mes¬ 
sage that appears on the screen 
points us in the direction of a 
badly constructed SNMP request. 
We now need to compare the data 
in our SNMP Get request against 
the X/Open structure. 

In Figure 3, we can see that 
there is an obvious error in the sev¬ 
enth line* We coded this as 
HP.VIR.BIND^LIST, which is not a 
valid entry according to Figure 2. 
This should have been coded as 
MP_VAR_ID_II5L 

Another error that needs to be 
corrected is in the eighth line* The 
MIB-n variable ID has been entered 
incorrectly* It should be coded 
1*3.6,1*2*1.3.6*0. 

The SNMP response format, 
shown in Figure 4, and code sam- 


Figure 3* SNMP error output 


pie, shown in Figure 5, illustrate 
how to programatically traverse 
the SNMP structures* If you grasp 
the recursive nature of the XMP 
pointer, extending this routine for 


other XMP formats is very 
straightforward* 

The C module that contains the 
debugging routine has a helper 
routine that extracts the SNMP 
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response data called GetSNMPData. 
Our program shows its use when 
the returned data is displayed. 

As you can see, the SNMP 
structure is somewhat foreign to 
most normal structures, but it is 
easy to use once you understand 
the basics. And, in most cases, 
debugging of the communications 
part is just as easy. 

You can now use this fully func¬ 
tional SNMP management program 
that you can extend to access any 
HIB-n variable. You can also access 
any private SNMP extensions that a 
vendor may have added as long as 
the variable IDs are provided. 

For a good book on SNMP 
from a programming point of 
view, I recommend Marshall 
Rose's The Simple Book, If you plan 
to create any LAN Net View-based 
management programs, you will 
need the LAN NetView Developers 
Guide, the XOM and XMP specifi¬ 
cations manuals from the X/Open 
Company Ltd., and the Internet 
specifications relating to SNMP 
(such as RFC 1213 and RFC 1157). 

Although the listings pre¬ 
sented here are only excerpts, the 
entire program (with make file) is 
available on CompuServe in the 
OS/2 Developer forum, OS2DF2, 
in the file LNYSNHP.ZIP. 


THE GOOD, THE BAD, AND THE UGLY 

Overall, LAN NetView provides a 
good entry-level management sys¬ 
tem. The platform is stable from 
developer and user viewpoints. 
IBM does provide applications 
with LAN NetView, but they are 
generally limited to local LANs 
only or OS/2-based WANs. 

The current lack of useful LAN 
NetView applications supporting 
WAN-based DOS and Windows 
agents reflects a great deficiency. 
Only vendors that are providing 
SNMP-based agents will fill this 
requirement. 

Recently, it has been reported 
that LAN NetView was to be 


// This routine will search the SNMP structure looking for a 
// match with the desired ID. When found, the ID's data is 
// returned in Data parameter. 

int GetSNMPData { 0M_workspace Workspace, 

OM_pub!ic_object SNHPStruct, 
char *ID, char ♦Data ) 

{ 

int Found = 0; 

OH_object_identifier DID: 

Data[0] = '\D'; 

while ( SNHPStruct->type !- DM JQJIORE.TYPES 
&& Found — 0 ) { 
switch ( SNMPStruct-Hype ) { 

// This can be thought of as a 'Header' for SNMP 
// data that will follow (recursive), 
case MP_VARJIINQ_LI$T: 

Found - GetSNMPData ( Workspace, 

$NMP$truct->value.object.object, 

ID, Data ); 
if ( Found = 1 ) { 
return Found; 

} 

break; 

// If MP_NAME, then this contains the ID of the 
// value returned. If the IDs match, then the next 
// element must be the value, which therefore must 
// have the type MPJIIUE. If this is true, then 
// recurse to get the value. We will then be 
// looking for MP.SIWPIE elements, 
case MP_NAME; 

at_strjto_oid ( ID, &0ID ); 
if ( at.oidjnatch ( &DXD, 

&SNMPStruct->value.string ) == 

QMJRUE ) { 

SNMP5truct++; 

if ( SNMPStruct-Hype == MPJALUE) { 

Found = GetSNMPData ( Workspace, 

SNMPStruct->value.object.object, 
ID, Data ); 
if ( Found = 1 ) { 

at_free ( DID.elements }; 
return Found; 

> 

} 

} 

at.free ( DID.elements ); 


Figure 5. Code extract of SNMP decomposition routine (continued on page 52} 
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Client/Server 
Database Solutions 


It’s available now - ready to per¬ 
form on your desktop. A new 
function-rich, 32-1)it relational 
database you can really trust 
with your growing client/server 
network, your mission - critical 
data and your business. 

Introducing IBM DATABASE 2™ OS/2 
(DB2/2™) from IBM Software Solutions, the 
birthplace of relational database technology. 

DB2/2 includes an industrial-strength DB 
engine that supports transaction management, 
concurrency control, security, integrity, and 
recovery functions. Designed to exploit the 
power and open architecture of OS/2, it also 
supports industry-standard SQL for developing 
portable applications. And it runs your DOS, 
DOS Windows™ and OS/2 
applications requiring 
online access. 

You can access data 
directly from DB2/2 on 
your desktop or from a 
DB2/2 server on your 
LAN, and with 



DISTRIBUTED DATABASE 
CONNECTION SERVICES/2,™ 
from DB2f SQL/DS,™ and OS/400* 
databases as if they were on your desktop, too. 
This versatility can play a significant role in 
an Information Warehouse™ solution 
for your business. 

WeVe developed an 




exciting demo diskette to show 

you just how well new DB2/2 

performs - right on your desktop. Call us today 

for your free demo, or to order DB2/2: 

1-800-342-6672; or fax: 1-800-445-2426, 

In Canada, call 1-800-465-7999, ext 850. 

An upgrade from OS/2 Extended Edition 
or Extended Services is also available. 




IBM. OS/2, DB2 and OS/4QC are registered trademarks and DATABASE 2. DB2/2. DISTRIBUTED DATABASE CONNECTION SERVICES/2. 
SQL/DS and Information Warehouse are trademarks of International Business Machines Corporation. Windows is a trademark of 
Microsoft Corporation © 1993 IBM Corp. 












replaced by an OS/2 version of 
IBM's AlX-based NetView/6000, 
The truth is that the SNMP APIs in 


NetView/6000 will be ported to 
LAN NetView. This addition to 
LAN NetView should strengthen its 
SNMP capability. 

You now have the basic abilities 
to query any SNMP agent on your 
network. Your next task is to dis¬ 
play the results in LAN NetView's 
View display The View User Interface 
Developer's Guide shows you how. 


Stacey Taylor, Network Teles is Inc., 
Calabasas, Calif. f is a senior software engi¬ 
neer for the development of the company's 
Response Time Analysis product for LAN 
NetView, He can be reached on CompuServe 
at 73670,3235, 
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Figure 5. Code extract of SNMP decomposition routine (continued from page 50) 
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APPLICATIONS DIRECTORY. 

This is the complete guide to solu¬ 
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This article contains practical information for network application developers, including coding errors to 
avoid and answers to typical configuration management problems. Developers will also find the tracing 
information and examples of classic errors helpful when debugging their network applications 

By TOM ELLIS and MIKE MCINTYRE 


NetBIOS and 802.2 Applications: 
Problems and Solutions 


* 


/ f you are a developer of network 
software that uses either NetBIOS 
or 802,2 APIs, you may want to 
consider the following tools and 
advice. For those of you who are writ¬ 
ing your first network application, we 
include some samples and information 
that you may find useful In addition, 
we dug into our files to present com¬ 
mon and unusual problems encoun¬ 
tered by programmers and offer some 
potential solutions. 

If you are just getting started on a 
network application, there are some 
basic sample programs available for 
NetBIOS and 802.2 that can save you a 
lot of time. Although they come with the 
IBM LAN Technical Reference , they have 
been updated to be either 16- or 32-bit 
and now are provided with makefiles, LRF 
and DEF files, and detailed instructions. 

There are also several INC and H 
include and header files that contain 
all the data structures for C and MASM 
source. IBM will reissue the sample 
programs and include files with the 
updated LAN Technical Reference . The 
programs and files are available now 
on CompuServe in the OS/2 Developer 
forum, 0S2DF2. The OS2DF2 section 
also contains some of the latest fixes of 
transport modules as well as descrip¬ 
tions for these files. 


SYSTEM TRACING FACILITY AND SNIFFERS 

Many programmers are not aware of the 
system tracing facility that is part of the 
OS/2 base operating system. Different 
from the Communications Manager 
traces, the system tracing facility helps 
track commands and frames visible at 
the transport layer and records different 
types of system events. The major event 
code for NetBIOS and 802.2 events is 
164, which is activated by typing TRACE 
ON 164 at an OS/2 command prompt 

So, what can the 164 traces do for 
you? This tracing shows network activity 
with NetBIOS and 802.2 ring 3 APIs and 
the link control layer. That is, it shows 
what happens to your commands and 
whether they result in any network-frame 
activity. There are a variety of network 
sniffers in use, but they can only track the 
actual frames on the wire without con¬ 
necting them with a specific application. 

Sniffers are helpful, if you suspect 
that frames are not making it over a 
series of bridges or if you want to moni¬ 
tor the link-level activity closely for 
some reason. They have a relatively large 
storage capacity as well as several filter¬ 
ing capabilities. The 164 traces have a 
smaller buffer but give you an exact pic¬ 
ture of interactions with your transport 
applications. The 164 traces trace API 
commands, frame headers, and user 
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00 00 00 00 00 00 00 44 

54 45 53 54 20 20 20 20 

PID [0000] MAJOR [A4] 
00 00 00 00 00 00 00 41 

47 57 4F 56 31 20 20 20 

PID [0000] MAJOR [A4] 
00 00 00 00 00 00 00 41 

35 30 56 5A 30 20 20 20 


i wv'w __bTH [002E] TIME: 

49 56 37 35 46 49 4E 20 20 20 20 20 20 
20 20 20 20 00 00 00 

MINOR [0064] LENGTH t002E] TIME_135 
55 53 44 57 4D 31 20 20 20 20 20 20 20 
20 20 20 20 00 00 00 

MINOR [0064] LENGTH [002E] TIME: 102 
55 41 35 30 56 44 30 20 20 20 20 20 20 
20 20 20 20 00 00 00 


2C 00 FF EF 08 
20 00 48 59 50 

EVENT# [0002] 

2C 00 FF EF 08 
20 00 41 55 53 

EVENT# [0003] 

2C 00 FF EF 08 

20 00 41 55 41 

EVENT# [0004] 

2C 00 FF EF 08 

20 00 4C 39 35 

EVENT# [0005] PID [0000] MAJOR [A4] MINOR [0064] LENGTH [0°2E] TIME: 87 

2C 00 FF EF 08 00 00 00 00 00 00 00 41 55 53 41 34 41 53 44 20 20 20 20 20 20 

20 00 41 55 53 41 34 41 53 31 20 20 20 20 20 20 20 00 00 00 

EVENT# [0006] PID [0000] MAJOR [A4] MINOR [0064] LENGTH [002E1 TIME 

2C 00 FF EF 08 00 00 00 00 00 00 00 44 S3 56 47 52 50 30 31 20 20 20 20 20 20 

20 00 43 53 56 47 52 50 30 31 20 20 20 20 20 20 20 00 00 00 


PID [0000] MAJOR [A4] MINOR [0064] LENGTH C002E] TIME_ 94 
00 00 00 00 00 00 00 41 30 34 4C 41 42 20 20 20 20 20 20 20 20 
5F 30 32 20 20 20 20 20 20 20 20 20 00 00 00 


urn 


Figure 1. TRACEFHT output 


data up to 128 bytes, whereas net¬ 
work sniffers trace frames only and 
cannot trace the transport APIs. 
These APIs can be command con¬ 
trol blocks (CCBs) for 802.2 or net¬ 
work control blocks (NCBs) for 
NetBIOS. When you are develop¬ 
ing a new network application, 164 
tracing is the tool to use. 

To setup and collect a trans¬ 
port trace, you need to follow cer¬ 
tain steps. First, include TRACEBUF=63 
in CONFIG.SYS to allocate space for 
system trace buffer. Second, 
include in PR0T0C0L.INI under the 
LANDD or NETBEUI section header the 
appropriate trace keyword and 
trace mask. The NTS/1 LAN Adapter 
Support (LAPS) Configuration Guide 
explains these keywords and masks. 
Third, type TRACE ON 164 at an OS/2 
command prompt to start tracing. 
You can automatically start tracing 
at system ipl time, if you include 
TRACE=0N 164 statement in the CON¬ 
FIG.SYS file. 

Once the event you wish to 
trace has occurred, stop the trace by 
typing TRACE OFF at an OS/2 com¬ 
mand prompt. Next, type TRACEFHT. 
This invokes a Presentation 
Manager program that allows you 
to save your trace data to a disk file 
in either flat ASCII or binary form. 
If you plan to format the data fur¬ 
ther by using DTF3.EXE, save the 
trace data to an ASCII file before 
using DTF3.EXE. Then, invoke DTF3.EXE 
to produce a formatted trace data 
file called TRACEFHT.DTF from an 
input trace file called TRACEFHT.SAV 
by typing DTF3 TRACEFHT.SAV > 
TRACEFHT.OTF at an OS/2 command 
prompt. You now have a trace that 
shows CCB/NCB level detail at 
the transport APIs. 

Since the trace buffer wraps 
within seconds, we've added some 
parameters to make 164 traces eas¬ 
ier to use. One is TRACEOFF, which is 
valid for 802.2 and NetBIOS. TRACE¬ 
OFF turns off traces when a speci¬ 
fied return code is detected. The 
other is TRACENAHES, which is specifi¬ 


cally for use with NetBIOS. TRACE¬ 
NAHES filters tracing to activity 
between the local machine and a 
specified remote NetBIOS name, 
thus eliminating irrelevant frames 
from the trace data and helping to 
save buffer space. You set these 
parameters by inserting them into 
the appropriate place in PROTOCOL.BII. 
See the LAN Technical Reference or 
the READHE file in the NTS/2 correc¬ 
tive service diskette (CSD) for 
details. 

Figures 1 and 2 show two 
examples of trace output. Figure 1 
is an example of the output that 
the TRACEFHT program gives after a 
164 trace has been taken. Figure 2 
is an example of the output from 
theDTF3.EXE program. 

PROBLEM DETERMINATION 

At this point, you're testing your 
application on a network that con¬ 
tains several, if not hundreds, of 
nodes connected with series of 
bridges. Something goes wrong. 
How do you locate the problem? 

When isolated, the problem 
will fall into one of six categories. 
The first four types of problems are 


solvable when you complete the 
diagnosis. The remaining two 
require help from IBM support. 

Configuration and Resource 
Management. After noticing a prob¬ 
lem that may be transport-related, 
look in the LANTRAN.LOG file for possi¬ 
ble messages that may direct you to 
adjust some configuration parame¬ 
ters in PR0T0C0L.INI. 

If the problem is not apparent 
in LANTRAN.LOG, try reproducing the 
problem with the 164 traces active. 
Once formatted, the trace may 
show a bad return code or notifica¬ 
tion of a status event that you can 
look up in the LAN Technical 
Reference. 

Application Program Problems. If 

your application traps, causing a 
pop-up to appear on the screen, 
but the system is still running, it's 
very likely that you have an appli¬ 
cation bug. The CSLIH gives the off¬ 
set in your program where the trap 
occurred. If you get a trap that 
stops the whole system, an inade¬ 
quate stack size passed in by the 
application could be the cause. 
Pointers passed in by the applica¬ 
tion could trap the machine, if they 
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are invalid. You really need to find 
out what kind of trap has occurred 
to determine whether it is the 
application or transports. 

Hardware Problems* Yes, many 
times an erratic problem plagues a 
certain machine, and it turns out to 
be a bad adapter or cable. Bad 
adapters can run for several hours 
without error and then suddenly 
deliver corrupt data. Bad cabling 
can cause intermittent beaconing 
or lobe wire faults on Token Ring; 
on Ethernet, it can prohibit connec¬ 
tivity between certain machines. 
Make sure you have those wretched 
terminators attached. 

Bridge Malfunction/Configuration. 
To diagnose bridging problems, 
you really need sniffers or similar 
network analyzers on both sides 
of the bridge. In this case, the one 
node sends frames, but the 
frames never arrive at the other 
side. Determine in which segment 
in the network the frames fail to 
appear. Then, look at the bridge 
between those two segments to 
isolate the problem to the particu¬ 
lar bridge. 

Traps and System Lockups . 

These types of traps stop the 
entire system. If your system 
traps and displays trap-register 
information, you may be able to 
tell in which specific driver the 
trap occurred by looking at the 
CSLIH value. You need to use a 
debugger, such as the Kernel 
Debugger, to debug traps and 
system lockups. IBM will also be 
able to aid in problem determina¬ 
tion for traps and system lockups. 
To determine if the problem may 
be in the transports, check 
the CSLIH against the values 
shown in Figure 3. Even if the 
trap is in one of these drivers, the 
problem can still be related to the 
application. 

The CSLIH values in Figure 3 are 
for LAPS version 2.11 (NTS/2). NET¬ 
BEUI and LANDD have values for 16-bit 
and 32-bit code selectors. 


If you have a release of LAPS 
later than 2.11 these values may be 
slightly larger. Media access control 
(MAC) drivers can also cause sys¬ 
tem traps infrequently, but you will 
need to call support to make that 
determination. None of these dri¬ 
vers traps in normal operation. 

Base Operating System. If the 
CSLIH value is not dose to one of 
the values shown in Figure 3, it is 
possible that the trap is in the base 
operating system. Don't count on 
this, since the base system rarely 
traps because of an application 
error. Still, if your machine is com¬ 
pletely locked up, support can 
help you determine if the base sys¬ 
tem is involved. 

EXAMPLES OF 

CLASSIC NETBIOS ERRORS 

Reusing NCB before it is complete . 

A common NetBIOS application 
bug is reusing an NCB before it is 
complete. When the NCB does 
complete, it looks like the second 
one completed. This can cause 
any number of undesirable 
events that you may not be aware 
of. It might look like you did 


everything correctly and that 
NetBIOS just corrupted your 
data. This can happen in a num¬ 
ber of ways. One is queuing the 
completed NCB somewhere and 
assuming it will get processed 
before the new one with the same 
address gets written to. 

On no wait command, check 
completion code , not return code , 
Your no-wait NCB never com¬ 
pletes, but you received the data. 

Although it sounds simple, 
make sure you checked the com¬ 
pletion code and not the return 
code. 

The iCSHETB.DLL is there r but the 
NetBIOS device driver {00) is not 

You keep issuing commands to 
ACSNETB,DLL, and some of them com¬ 
plete, but all the others give cata¬ 
strophic return codes. And you 
know this application works on 
other machines. 

Maybe the NetBIOS device 
driver or a MAC driver did not 
load. Some commands will return 
immediately when issued to the 
dynamic link library (DLL), so it 
looks like some commands are cor¬ 
rect, Check the LANTftAN.LOG file to 



Figure 2, DTF3 output 


58 


OS/2 DEVELOPER 











Figure 3. CSLIM values for LAPS version 2.11 


see if the drivers loaded. 

Setting priority thread too high in 
application program. Your applica¬ 
tion hangs, waiting for NetBIOS to 
complete some command. Did you 
set your thread priority higher 
than NetBIOS itself? 

There are two different priori¬ 
ties set for EE 1.3 and LS 2.0 and 
above. The LS 2.0 and later priority 
is lower than EE 1.3 NetBIOS, so be 
aware of this when moving an 
application to the NDIS version 
and setting thread priorities. 

No outstanding Receive.any. If 
your NetBIOS program will not 
accept data or is running unusu¬ 
ally slow, a Receive command that 
was not issued quickly enough 
may be the cause. 

When NetBIOS data arrives at 
your machine, NetBIOS will accept 
it only if you issue a Receive com¬ 
mand with sufficient buffer space 
available to hold the data. It is 
good practice to reissue a Receive 
on the appendage when a Receive 
completes, so you will be less 
likely to miss incoming data. 

Not enough loopback packets 
configured. You are using a redi¬ 
rected drive that is local to the 
LAN Server machine, but the 
application just hangs, and you 
can't get access. When you try to 
get to that drive from a remote 
machine, everything is fine. 

This looks like the NETBEUI 
loopback packet is set at the 
default setting of 1, which should 
be raised to 5, for example, if you 
are actually using the loopback 
feature. 


Message number LT00065 shows 
up in LANTRAN.LOG. Usually this means 
that the resources don't fit into the 
NetBIOS 64K data area. This is not 
the same as the NETBEUI RAM calcu¬ 
lations for NetBIOS, as given in the 
NTS/2 configuration guide. There 
is only one 64K data area for all 
adapters for the NETBIOS.0S2 module. 

To determine the resources to 
allocate for NetBIOS, the sum of 
the following calculations must be 
less than 65,536: 

• 11200 bytes overhead 

• 95 bytes for each NCB available 
to NetBIOS applications 

• 15 times (NCBs available minus 
15). Use 0 if less than 0 

• 990 for each adapter configured 
for NetBIOS. 

EXAMPLES OF CLASSIC 802.2 ERRORS 
Direct Station use in 802.2 (DOS vs. 

OS/2). When programming to the 
802.2 API in DOS Direct Station, 
you obtain ownership by issuing 
DIR.OPEN.ADAPTER. In OS/2 Direct 
Station, you obtain ownership by 
explicitly issuing DIR.OPEN.DIRECT. 
Also, keep in mind that only one 
application can own the Direct 
Station on an adapter at one time. 
This is important in determining 
which applications can coexist on 
one adapter. 

Freeing service access point 
(SAP) buffers twice. A common 
problem arises when using buffers 
from the SAP buffer pool. When 
users need a buffer to transmit 
data, they use BUFFER.GET to transfer 
ownership of the buffer from the 
protocol stack to the user. Once the 
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Travel with the team that knows the way... 

The Object People 

"Your Smalltalk Experts" 


MtaiK txpercs 

^ /SWMVt\ HBH 


Education & Training 


Project Related Services 


ConsultingStMenfon^^^^ 
Rapid Prototyping 
Custom Software Development 
Legacy Systems 
GUI's, Databases 
Client-Server 


Smalltalk/V Windows and PM 

• PARTS 

• Objectworks\Smalltalk 

• VisualWorks 

• Smalltalk for Coboi Programmers 

• Analysis & Design 

• Project Management 

• In-House & Open Courses 

The Object People Inc. 509-885 Meadowlands Dr., Ottawa, Ontario, K2C 3N2 
Telephone: <613) 225-8812 FAX: (613) 225-5943 

Smalltafk/V and PARTS are registered trademarks of Oigilalk, Inc. 

Objectwofks and VisualWbrlts are trademarks of ParcPlMe Systems Inc. 
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Looking for 
fast answers 
to your 
development 
questions? 


You need to do two things. 
Go on-line with CompuServe 
Information Service. Use 
Golden CommPass to do it. 

CompuServe hosts OS/2 
developer and user forums, 
monitored by technical 
personnel. IBM developers 
are there with responses to 
anything that’s got you stuck. 
Other OS/2 programmers and 
enthusiasts are there, too, 
comparing notes and giving 
feedback. It's definitely the 
place to be. 



Golden 

CommPass 


06/2 Navigation Software 


Time is money when you 
connect to CompuServe, and 
Golden CommPass saves 
you both. It lets you compose 
your questions off-line, send 
them in a flash and disconnect. 
It gets your replies while you’re 
busy programming. 

Golden CommPass keeps 
your development schedule 
on course. The fact is, the 
sooner you start using our 
program, the sooner they’ll be 
talking about yours. 



Creative Systems Programming Corporation 

Post Office Box 961 * Mount Laurel, NJ 08054-0961 
(609) 234-1500 - Fax: (609) 234-1920 * CompuServe: 71511,151 
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users are finished with the buffer, 
they use BUFFER. FREE to return own¬ 
ership of the buffer's memory back 
to the protocol stack. Also, the pro¬ 
tocol stack takes buffers from the 
pool and fills them with data when 
inbound data is received* 802.2 
does no checking to prevent a user 
from freeing a buffer more than 
once. Unpredictable results occur. 
When a buffer is on the free queue, 
freeing it again causes 802.2 to cre¬ 
ate a circular linked list of queue 
elements and from there many 
problems crop up. 

Reuse of CCB before it's com¬ 
plete . 802.2 will reuse CCB memory 
before the CCB is completed, 
which is a tricky application bug. 
A common symptom of this is that 
802.2 appears never to complete a 
specific CCB. Just as likely, the 
symptom shows up as a system 
trap or as unexpected results on 
command completion. 

Applications using same source 
SAP number If an 802.2 application 
opens a specific SAP and another 
application attempts to open the 
same SAP on the same adapter, 
you get a return code of x'43', 
informing you that the SAP num¬ 
ber is already in use. 

Completion flag set in CCB may 
cause out of queue elements error. If 
an 802.2 application issues CCBs 
with the command completion 
field set to a nonzero value, the 
application wants to be notified of 
command completions retrieved 
using READ commands. If the com¬ 
mand completion field is set and 
no READ commands are issued for 
command completion events, 
queue elements are internally 
accumulated, and eventually a 
return code is given back stating 
"out of queue elements". 

GENERAL PROBLEMS 

Here are some examples of gen¬ 
eral problems users have experi¬ 
enced on their networks and how 
they were solved. 
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Sessions going down on slow 
links . Several networks had prob¬ 
lems with links and sessions going 
down when data was sent across 
transparent bridges or slow 64K 
links* Tracing showed the T1 timer 
expiring before the link was taken 
down* The data and the corre¬ 
sponding acknowledgment frame 
did not get across the line before 
the retries were exhausted* The 
solution was to increase the T1 
timer* The DLC retries parameter 
could also be increased, but then 
there would be lots of unnecessary 
resends of frames getting sent and 
discarded. 

Deallocating application memory 
causes a trap * One user caused a ring 
0 trap in the NetBIOS device driver. 
In this case, the program allocated 
ring 3 memory and issued a com¬ 
mand in which NetBIOS would use 
the memory to complete the com¬ 
mand. However, the application 
freed the memory before the com¬ 
mand completed. NetBIOS vali¬ 
dated the address on entry, but it 
was invalid upon completion. 

Application does not have 
response for all possible return codes * 
An example of a common applica¬ 
tion bug is inadequate return code 
handling. Many applications have 
processing for only a limited num¬ 
ber of return codes, but when 
something unexpected happens, 
one of these other return codes can 
be hit. Anything can happen at this 


point* Make sure return code han¬ 
dling is detailed enough. 

Application fails after going into 
debugger If you are debugging a 
ring 0 network application, and 
you have problems getting frames 
to be sent after a command is 
issued, it might be that the adapter 
is closed because it timed out. This 
happens when stepping through 
code in ring 0. People have wasted 
hours thinking their application 
was doing something wrong. 

You are running Ethernet DtX but 
configured for 802.1 You have con¬ 
figured a new Ethernet machine, 
but it can't communicate with 
other machines or the frames can't 
make it across bridges* 

It could be that all the other 
machines and bridges are using 
the DIX frame format, but you 
have inadvertently configured the 
new machine for 802*3* People 
have spent days figuring out this 
trivial problem. 

LAN Server tocks up * You are run- 
ning a LAN Server or Requester 
machine* Suddenly, it locks up, and 
you have to power it off* It then 
runs for a while but soon locks up 
again* You probably are out of disk 
space for the swapper or have insuf¬ 
ficient RAM* Servers with 6MB of 
RAM are vulnerable to this* 

Bridging and duplicate address 
errors. You have a large network 
with many bridges. The machines 
running 802*2 applications receive 


REFERENCES 

IBM LAN Technical Reference , SC30-3587-00* 

NTS/2 LAN Adapter and Protocol Support Configuration Guide, 
S96F-8489-00. 

IBM Token-Ring Architecture Reference , SC30-3374-02. 


duplicate address errors on boot up. 
You are certain that you don't have 
a duplicate address on the network. 

Several customers have dis¬ 
covered that a malfunctioning 
bridge can echo frames generated 
by the duplicate address test done 
by UNDO at boot-up. This makes it 
look to UNDO as if there is another 
node responding to the address 
test frames* A sniffer can locate the 
bad bridge by showing routing 
information. 

LAPS won't install due to locked 
files * When trying to install LAPS 
over an existing version of LAPS, 
the system gives an error message 
about locked files and ends the 
install. The message persists even 
after rebooting* 

The solution is to remove the 
IBHUNLK.LST file from the \0S2\ 
INSTALL subdirectory and reinstall 
LAPS. 

If you've read all this and still 
think that the transport has a prob¬ 
lem, licensed users of NTS/2 and 
LAN Server can contact IBM 
Support at 1-800-992-4277, 



Mike McIntyre joined the LAN 
Transport development team at IBM 
Austin in 1981 He was a developer on 
several projects including the IEEE 802.2 
protocol stack and IEEE 802.2 Virtual 
Device Driver He is currently a member 
of the team working on Multi-Protocol 
Transport Services for OS/2. He received 
a B.S. in electrical engineering from Penn 
State University 


Tom Ellis joined the LAN Transport deveP 
opment team at IBM Austin in 1988. He 
was the level 3 support lead for the 
NetBIOS and 802.2 interfaces during the 
last two years r He is currently working as 
a developer on enhancements to the 
NetBIOS interface. He graduated from 
Ohio State University in 1388 with a B.S . 
in computer and information science. 


MARCH/APHtL 19 9 4 


61 










OS/2 PRODUCTS & SERVICES 


1RMWARE SERVICES 

EDPT - Employee Development Planning and Tracking a low cost solution to fully 
automate Human Resource procedures (may be customized to meet your needs). 

E/R DIAGRAMMER - An inexpensive entry into CASE technology that remains 
methodology independent without losing the precision of binary cardinalities. 

IRMWare specializes in custom business solutions and software development 

FREE PRODUCT BROCHURE OR CONSULTING INFORMATION: 

(602) 730-1510 or Fax (602) 413-0399 • P.O. Box 51093 • Phoenix, AZ 85076-1093 


_ Circle Reader Service N umber 32_ 

John C. Dvorak's Favorite 

" The best of the best...Hobbes OS/2 CDROM... Lots of nifty utilities, fonts, and 
other goodies on this CD." - John Dvorak, PC Computing, Oct. 93. 

Hobbes is 2800 files from the largest ftp archive of OS/2 material, ftp-os2. 
cdrom.com, quaintly known as Hobbes. Hobbes serves as the major internet distrib¬ 
ution site of OS/2 freeware, shareware, device drivers, program updates and infor¬ 
mation. We bring this entire archive to you in the well organized, indexed, and virus 
scanned Hobbes disc. Many programs are installed on the CDROM, so you can run 
them without using any of your hard disk space. 

The Hobbes OS/2 CDROM is updated quarterly and last updated in October 1993. 
Start enjoying this disc now. We guarantee your satisfaction. 

$29.95 Many more products available. 

Walnut Creek CDROM • 4041 Pike Lane, Ste D-98 • Concord, CA 94520 

1 800 786 9907 

♦ 1 510 674 0783 FAX: +1 510 674 0821 info<@>cdrom.com_ 
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MISSING SOMETHING? 

Complete bade issue library available today! 
Every back issue of OS/2 DEVELOPER can be 
yours . 

Call today and complete your library: 
1-800-WANT-OS2 




Schedule Programs and Reminders ... 

Chrori v4.0 

Scheduling Software for OS/2 

New version.only $99 


9? m P Utln 9 Voice: (913)780-5051 

1022 N. Cooper BBS/Fax: (913) 829-2450 

Olathe, KS 66061 CIS: 73457,365 
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Attention Mathematica users: 

Everything you need to know to get the most out 
of your math programming Is In 

THE MATHEMATICA JOURNAL 

Cadi or fax today for Information about 
subscriptions and special Issues: 

Phone orders: 415-905-2332 
Fax orders: 415-905-2233 




SUBSCRIBE TODAY! 

Only $39.95 for a full year subscrip¬ 
tion to the premier source of tools and 
techniques for the OS/2 software 
developer: OS/2 DEVELOPER 

Call today and don't miaa a single Issue: 

1-800-WAUT-0S2 


Y0UR<^#*S0URCE F0 
OS/2 APPUCATI0NS 


ununES 


PRODUCTIVITY SOFTWARE 


BOOKS & VIDEOS 
OS/2 T-SHRTS 
BACKUP SOFTWARE 
DEVELOPMENT TOOLS 


GRAPKCSBCAD 
C0MAWCAI10NS 
NETWORKING 
WORD PROCESSING 

ORDERS: 1-800-776-6264 
FAX: 919-878-7479 
NOUNES: 919478-9700 



CATALOG 
NOW AMIABLE 



3209 Gmdwnn Idee Rood. S>J» 315 Rde&\ NC 27615 USA 
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♦Men 

tfechnolouv Inc 

iwiuwivgj^ llvUi 


REMOTE LAN. 
NETWORKING 


Remote Vision extends LANs transparently over dial-up connections. 
Remote Vision provides access to a LAN from remote machines or 
remote LANs. Remote DOS, Windows, and OS/2 machines have a 
simulated network adapter. 

Communications to the LAN is provided by the Remote Vision Server 
and async modems. Most LAN protocols and applications work, includ- 
ing NetBIOS, Named Pipes, APPC, 802.2, TCP/IP, and IPX. Call 
(415) 965-8607 and use option 2 for a free fax-back. 
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Opt-Tech Sort/Merge 

High Performance Sort/Merge/Select Utility 


Use as a stand-alone utility or call as a Subroutine, Many 
features including unlimited file size, multiple keys, record 
selection, duplicate elimination, summing and more! 


Call for free brochure 

Available for: 

OS/2 or Unix $249 
DOS or Windows $149 


Opt-TechData Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 
Phone (702) 588-3737 
Fax (702) 588-7576 
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GET AN EDGE ON YOUR MARKET 


With customized consulting 
services for OS/2 & client 
server applications: 

• Programming • Design 

• Project Management • Testing 

■ System Analysis • Installation 

_ * Maintenance __ 

REAL-T IMF (800) 441-9241 

TECHNOLOGIES (708) 441-9240 

1001 Greeribay Rd, Winnerka, IL 60093 
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The OS/2 Developer 
Product & Services Guide 

The most cost effective way to reach 
36,000+ qualified professional 
OS/2 Developers 

New England/Midwest 
call Trish Sutter 

(212) 626-2498 

Middle Atlantic/Southeast 
call Dave Moreau 
(212) 626-2318 

West/Southwest 
call Angela Barnett 

(415) 905-4983 


FAX for OS/2 

From the developers of FaxWorks OS/2 and PMfax 

Client/Server API and Printer Driver Toolkits 
Support for LANs, up to 48 lines per CPU, 
and all popular fax hardware. 

Keller Group Inc. 


Voice: (6t2) 429-7273 

FaxWorks is a trademark of SofNet, Inc. 


Fax: (612)653-1987 

PMfax is a trademark of Keller Group 



TCP/IP for OS/2® 


Supports all released versions of OS/2 
including 32bit API for OS/2 2,0 and above 

Supports NDIS, CM, and ODI drivers 
Network access from protected, real, and WINOS2 sessions 
Full server operation for telnet, ftp, rsh and sendmail 
IP gateway capability 

NETBIOS, NFS ACCESS, SNMP TOOLS 
DOMAIN NAME SERVER 
DEVELOPERS KIT with socket library 
VT102 & 3270 emulation for remote login 

TCP™-OS/2 TRANSPORT MODULE„„„$ 200.00 

A DAN LANCIAN1 PRODUCT 
For further information contact: Essex Systems, Inc, 

One Central Street, Middleton, MA 01949 • (508) 750-6200 


TCP/2 is a trademark at DLD consulting. E the met is a trademark of Xerox Corporation. 
OS/2 is a registered trademark of International Business Machines Corporation. VT102 is 
registered trademark 61 Digital Equipment Corporation TCP/2 is based in part on 
work dona by the University at California Berkeley. 
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The easy to use 32 bit OS/2 PM IFF Language Editor 

IPF Editor 

Introductory Price: $95 

With Printed Manual: $125 

’ auu iMJijj iu ajjputituiJiis in liimiiicb 

* Designed for easy use by programmers and non-programmers 

* Generate C and Resource source files to 

add help to applications automatically 

* Import wordprocessing files, including 
WordPerfect, quickly and accurately 

* Preview IPF output without compiling 

* Create all hypertext links automatically 

* Optional voice and animation modules 

* Includes complete on-line help and 
documentation 

Orders and 
Information 
(206)428-5025 

tw CompuServe at 79410,24J6 

Per ez Computing Services 
4725 Monte Vista Place 

Mt Vernon, WA 98273 
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Announcing 

the 1st Annual 


OS/2 World 
Conference & 
Exhibition 


July 19-22,1994 

Santa Clara 
Convention Center 
Santa Clara, 
California 










Do 


' you want more support 
in your day-to-day use of OS/2? 

Is your company struggling to 
integrate OS/2 into its enterprise 
computing strategy? Do you want 
to take OS/2 to a higher level? 


□ S/2 World 
Will Point You In The 
Right Direction 


The independent technical program, 
featuring over 100 lectures, workshops 
and tutorials, will present you with the 
objective truth — both good and bad — 
about OS/2, IBM, and third-party 
providers. You can count on the infor¬ 
mation because our top-notch faculty 
won’t have a hidden agenda. More 
importantly, the technical program is 
geared to you, the OS/2 customer, not 
the industry. 

The technical program is broken out 
into 8 dynamic tracks: 

* Enterprise-Wide Networking 

* Client/Server and Information 
Management 

* Local Area Networking 

* Power Computing 

* Systems Administration 

* Corporate Software Development 
■ Personal Programming 

* Multimedia 

AN OBJECTIVE AND 
Balanced Faculty 


Classes will be taught almost exclu¬ 
sively by independent expert users, con¬ 
sultants, and trainers offering objective 
and balanced information to users and 
managers charged with deploying and 
maintaining OS/2 systems in corporate 
environments. Instructors will be 
experts who work with OS/2 in the field, 
and have implemented OS/2 solutions 
for their companies or clients. 


Industry-Wide 
Sponsorship 
Guarantees a Top 
Quality Event 

Produced by Miller Freeman, Inc., 
the third largest trade show producer 
in North America, the OS/2 World 
Conference 8t Exhibition is presented in 
cooperation with the IBM Corporation 
and sponsored by OS/2 Magazine , 
OS/2 Developer, DBMS , Database 
Programming and Design , LAN 


Magazine , STACKS: The Network 
Journal , Software Development and 
Dr. Dobb’sJournal 



Choosing The 
Right new Products 
Can Be Quite A 
Balancing Act 


The OS/2 World Products Exhibition 
is the only place you can get a hands-on 
look at the hardware and software that 
can make your system scream. You can 
pose your toughest questions as you 


meet face-to-face with the major players 
in the industry. This world-class 
exhibition will feature leading suppliers 
showcasing applications software, com¬ 
munications hardware and software, 
databases, network solutions, utilities, 
multimedia tools, and more. The 
exhibition will run Tuesday, Wednesday 
and Thursday so you will have plenty of 
time to get the answers you need. 


See the Future of 
□ S/2 Today 


Running parallel to the technical 
program will be dozens of presentations 
by key visionaries at IBM and major 
hardware and software providers. 
Topics include: OS/2 and Workplace 
OS, What It All Means To You • 
Customizing the Workplace Shell with 
REXX * Exploiting OS/2 Software 
Motion Video * Introduction To The 
OSE Distributed Computing 
Environment * And More. 

Don't miss this opportunity to learn 
what applications and opportunities 
aw f ait OS/2 users of the future, and how^ 
you can stay on the cutting edge. 

Phone, FAX or mail 
today for more inf or- 
mation on the OS/2 
World Conference 
& Exhibition, 




YES! Please send me in 

o on: | Attending 

| Exhibiting 


1 






NAME 





TITLE 

PHONE 




COMPANY 

FAX 




ADDRESS 





CITY 

STATE/PR0V. 

ZIP CODE 


*_ 

OS/2 World Conference flt Exhibition Attn: JulicAnn Lee 

600 Harrison Street! 4th Floor, San Francisco, CA 94107-9603 
Phone: (415)905-2354 Fax: (415) 905-2220 
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LAN 


The installation and configuration of applications on workstations across LANs are becoming increas¬ 
ingly important tasks for network administrators. IBM's CIO strategy advances recommendations for 
making your application easier to install and configure across a LAN. The following article describes the 
fundamentals of CID-enablement. It is an excerpt from OS/2 2.1 Application Programmer’s Guide, 
reprinted with permission from Van Nostrand Reinhold. By THEODORE SHRADER 


Enabling Your 
Applications for CID 



Theodore Shrader 


C omputers interconnected over local 
area networks are the fastest growing 
segment of the PC market today. Large 
companies are downsizing, moving their 
applications and databases from mainframes 
to LANs. These LANs involve anywhere from 
a hundred to several hundred workstations. 
Smaller businesses are discovering the advan¬ 
tages that connecting the PCs in their offices 
has over keeping them as isolated, stand-alone 
workstations. With the proliferation of LANs, 
installing and updating applications on com¬ 
puters have become increasingly important 
and complex tasks!, Feeding disks into a 
floppy drive for every new application is no 
longer a viable option .There must be a way to 
automate the installation and configuration of 
applicabons aci^ss a LAN efficiently and eas¬ 
ily Such a solution must also deal with the 
heterogeneous environments that exist in the 
marketplace today. 

IBM has advanced a strategy for products 
called CID, which stands for configuration, 
installation, and distribution. Software prod¬ 
ucts that are CID enabled adhere to guidelines 
and recommendations set forth for those 
applications that want to participate in the 
CID realm. CID enablement requires a differ¬ 
ent though not radical philosophy for the 
design and operation of your application's 
installation and configuration program. By 
investing the time and effort to make your 
product CID enabled, you will allow a net¬ 


work administrator to install, configure, and 
maintain your application across all the work¬ 
stations easily 

Enabling your product for the CID envi¬ 
ronment does not tie you to a specific distribu¬ 
tion mechanism. In fact, CID-enabled applica¬ 
tions can participate in a number of different 
distribution mechanisms, whether by using 
the LAN Configuration Utility (LCU) compo¬ 
nent of Network Transportation Services/2 
(NTS/2) or through the facilities provided by 
the IBM NetView Distribution Manager for 
OS/2 {NetView DM/2) application. Novell 
also supports CID-enabled applications. C1D- 
enabled products can exist in a heterogeneous 
environment transparent to whichever soft¬ 
ware distribution manager your customer 
uses. (Software distribution manager is a 
generic term for any distribution mechanism 
that operates in the CID environment.) 

Although distribution is an important 
part of CID, choosing a software distribution 
manager lies outside of the realm of influence 
of most software designers. Developers can, 
however, directly influence the way their 
product is designed to ensure that it can par¬ 
ticipate in the CID environment. 

CID-ENABLED APPLICATIONS 

Whenever a user installs an application, he 
or she usually performs the task in one of 
three ways. First, during attended installa¬ 
tion, the user must sit at the workstation and 
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nurse the floppy drive with disks. The user 
might also be required to enter installation or 
configuration data into panels at different 
stages of the installation. This installation 
approach is characterized by manual, time- 
consuming tasks the user performs at the tar¬ 
get workstation. 

Second, during lightly attended installa¬ 
tion, the user is not divorced from physically 
visiting the workstation, but the amount of 
work the user needs to perform is dramati¬ 
cally reduced. With such an approach, the user 
can start up the installation program for an 
application, possibly answer a few questions 
(such as what drive to install the product on), 
and walk away. Users can start the installation 
program by inserting boot disks or by execut¬ 
ing a program from another workstation that 
runs on the target workstation. 

Third, during unattended installation, 
the user does not even have to visit the target 
workstation. Users simply schedule the 
applications for installation on their target 
workstations through their software distrib¬ 
ution manager. This results in the unat¬ 
tended execution of the installation (or con¬ 
figuration) programs for one or more 
products on the target workstation. During 
the course of the installation of a product, 
the software distribution manager reboots 
the workstation as required by each installa¬ 
tion program. Successful or unsuccessful 
installations are reported back to the net¬ 
work administrator as implemented by the 
software distribution manager. 

When the term "installation program" is 
mentioned, it refers to the installation and con¬ 
figuration programs of a product. These pro¬ 
grams may be separate or combined, allowing 
one program to perform the configuration and 
installation of a product. Also, the terms "tar¬ 
get workstation" and "client workstation" can 
be used interchangeably. 

The optimal customer solution would be 
to have all applications installable in an unat¬ 
tended fashion. For example, the applications 
on all the workstations in an office could be 
installed and configured overnight from a 


remote site and be ready for use in the morn¬ 
ing. However, unattended installation is not 
always possible, since some workstations may 
not have the support software to retrieve or 
communicate information across a LAN, for 
example. Nevertheless, getting products to a 
point where users can install and configure 
them in a lightly attended or unattended fash¬ 
ion will save a great deal of work, lower LAN 
maintenance costs, and ensure that products 
and upgrades are distributed to the target 
workstations on a LAN quickly and efficiently. 
A product with all these characteristics will be 
prized by network administrators. 

CID-enabled products can operate in 
lightly attended and unattended modes if 
they support two installation techniques. 
With the redirected installation technique, 
the installation program for the application 
must be able to retrieve its code images (in 
such forms as compressed files or disk 


\QD 

\CLIENT (stores the client command files, such as those 
used by the LAN CID utility) 

\DLL (stores .DLL files, generally those used in the EXE 
directory) 

\EXE (stores executable programs files) 

\IHG (stores the disk images or product files—each sub¬ 
directory pertains to a specific product) 

\PR0D1 

\PR0D2 (and so on) 

\CSD (stores the Corrective Service Disk or Service Pak 
images for a product—each subdirectory pertains to a 
specific product) 

\PR0D1 

\PR002 (and so on) 

\L0G (stores the log and history files for a product- 
each client subdirectory pertains to a specific product) 
\PR001 

\PR002 (and so on) 

\RSP (stores the response files for a product—each 
client subdirectory pertains to a specific product) 

\PR0D1 

Table 1 . Directory structure for products available on a code server 
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images) from any drive, whether a net- 
work redirected or CD-ROM drive. A 
network redirected drive physically 
exists on another workstation on the 
LAN, but to a client workstation, it 
looks like a local drive because of the 
software installed on the client. Users 
should not have to use the floppy dri¬ 


ves on their workstations to install an 
application. To a large extent, redi¬ 
rected installation means that a prod¬ 
uct can be installed from across a LAN. 

With the response files technique, 
die response files, which are ASCII files 
with specific keyword and value syntax, 
replace the need for the user to input 


Rhetorex 

Voice Processing boards 
make CTI a reality. 



If you're 
asking 

"what's CTI,” 

you' re missing one of the hot¬ 
test new technologies going. 

Computer Telephony 
Integration Jinks PC-based 
computer applications to the 
telephone network, providing 
voice/fax mail, interactive voice 
response, and other telephony 
applications. 

Interested? Maybe you’re 
already developing a CTI 
application. Then it’s time to 
discover Rhetorex*™ 

The fact is, when it comes 
to multi-port voice processing 
components, no one offers more 
value than Rhetorex. 

With Rhetorex voice platforms, 
you’ll get state-of-the-art DSP- 
based technology, designed from 


the ground up for reliability. 
Sophisticated DSP algorithms 
give you unparalleled perfor¬ 
mance. Best of all, enhance¬ 
ments to algorithms are made 
via software upgrade. 

And Rhetorex products help 
you develop applications 
b quickly. All components 
M include device drivers, a 
W straightforward API, and 
sample programs. Friendly, 
free technical support is 
available at any stage of 
development. 

For the best value in CTI 
technology-from our 2 and 4 
port voice processing boards 
and fax boards, to our 24-port 
platform-then give Rhetorex a 
call. (408) 370-0881. And start 
making CTI a reality. 



RHETOREX 


Rhdorcv, Inc. 

200 E. Hacienda Avenue 
Campbell, CA 95008-6617 
Tel, (408) 370-0881 
Fax (408) 370-1171 
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installation and configuration values 
manually at install time. Response files 
remove the need for all users to know 
w r hat the installation and configuration 
parameters mean. The LAN administra¬ 
tor can provide a specific response file 
that tailors parameters, such as the max¬ 
imum database buffer size, for a group 
of workstations or a single workstation. 
A CID-enabled product will use a 
response file for its installation and con¬ 
figuration processes. Response files do 
not eliminate the need for a product's 
regular installation program. Users 
should still be able to install and config¬ 
ure their product through a windowed 
interface. 

Once a product supports redi¬ 
rected installation, response files, and a 
few additional command-line parame¬ 
ters for its installation program, the 
application has suited up as a player in 
the CID arena. 

There's a difference between a pro¬ 
duct's installation program and its regu¬ 
lar program, which may consist of sev¬ 
eral programs—the total of which is 
called the application. The installation 
program is used to install or configure 
the program from images or files on a 
disk or code server. It is typically run 
only once or very infrequently to estab¬ 
lish or configure a program on a work¬ 
station, The user invokes the application 
program files to use the actual product 

The configuration of a product 
need not take place at installation time. 
For example, users may want to change 
their configuration values for tuning 
purposes after installing and testing 
applications across their LAN network. 

CODE SERVER AND ITS DIRECTORIES 

The term "code server" is used fre¬ 
quently when describing how an instal¬ 
lation program can retrieve the response 
and product code files, whether in disk 
image or compressed format, for instal¬ 
lation on a target workstation. A disk 
image is a binary file containing the con¬ 
tents of an entire disk. Compressed files 
are created by compaction programs. 
The code server acts as a central reposi¬ 
tory that the installation program can 
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access using redirected installation. 

One such recommended directory 
structure for products available on a 
code server is shown in Table 1. 

The response files would have 
names like NODEOOOl.RSP and NQDE0002.RSP, 
for example, where the file names are the 
same as the client node names. The file¬ 
name \OD\RSP\LS30\N00E000tRSP would 
indicate to the user that the response file 
was for the target workstation named 
JIIDDE0001, and the response file was spe¬ 
cific to the LAN Server 3.0 product. 

The command files in the 
\CID\CLIENT\ directory are used as part 
of the software distribution manager 
target (or client) installation process to 
identify the products that need to be 
installed, the order of installation, and 
the commands needed to complete the 
installation. The software distribution 
manager the user chooses may require 
its own unique directory structure for¬ 
mat. With support for response files 
and redirected installation, your appli¬ 
cation need not concern itself with the 
functions of the software distribution 
manager, yet it will still be able to par¬ 
ticipate in the CID environment, 

REDIRECTED INSTALLATION 

To design your application to support 
redirected installation, your installa¬ 
tion program will need to support two 
functions. 

First, it will need to support the 
ability to transfer the images or con¬ 
tents of the program installation disks 
to a hard drive or to another medium. 
This allows network administrators to 
place your product images on their 
code server. 

Second, it will need to support the 
ability to retrieve the disk images or 
program files from a network, redi¬ 
rected, or nonfloppy drive during the 
installation process. 

Redirected installation does not 
mean your program cannot be installed 
from a floppy drive. In fact, being able 
to install from the I or B drive is still of 
paramount importance to the large 
base of stand-alone workstations. 
Supporting the installation of vour pro¬ 


gram from a floppy drive is still a pri¬ 
mary requirement for most applica¬ 
tions. Yet by extending your installation 
program to support redirected installa¬ 
tion also, you have extended the reach 
of your program to the stand-alone and 
LAN environments and made your 
application more attractive to LAN 


administrators and users. 

An application could use an operat¬ 
ing system utility program, such as 
KDPY, to transfer program files from its 
product disks to a code server. It also 
could use XCOPY to transfer files from a 
network or redirected drive to the target 
workstation. You don't need to build a 
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special function to accomplish this. 

Applications, including those not 
specifically designed to be CID enabled, 
have already started to support redi¬ 
rected installation. Typically, this takes 
the form of allowing the user to copy the 
contents of the program disks to a hard 
drive or network partition. Afterward, 


when the user starts the installation pro¬ 
gram, it will prompt the user at the 
beginning to ask for the drive and direc¬ 
tory path from which to retrieve the 
program files. These programs also ask 
for the target partition and directory in 
which to install the application. 

More sophisticated installation 
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programs will copy the disk images to 
predetermined directories on a target 
disk partition. These programs will 
even create the directory structures if 
they do not exist. Whether the user per¬ 
forms an XCOPY on the disks or uses the 
installation program to transfer files, 
supporting redirected installation helps 
move users away from having to per¬ 
form attended installation. 

RESPONSE FILES 

The main purpose of response files is 
to provide predetermined answers to 
all the possible installation and 
configuration prompts that the instal¬ 
lation program may ask the user. 
This frees the user on the target work- 
station from having to know the 
parameters, their ranges, and so on. 
Someone, perhaps the network 
administrator or an expert with the 
application who knows how to tune 
the parameter values for optimal per¬ 
formance, can build the response file 
for the client workstation before the 
installation program is even invoked. 

Again, response files do not 
replace the need for panels that prompt 
the user for values or ask the user to 
select from a list of choices. First time 
users may prefer this route with its con¬ 
text-sensitive help instead of leafing 
through a manual or installation guide. 
Response files may be useful, but are 
not a requirement, for stand-alone users 
who are not likely to install the pro¬ 
gram more than a few times. 

There are some programs, very few 
in number, that do not require the user 
to specify any installation or configura¬ 
tion parameters. (Even most of today's 
entertainment software will ask you to 
choose the sound cards and video dis¬ 
plays on your system to confirm or 
override any default selections it may 
have detected.) The net result is that 
without support for response files, your 
program may not be able to support 
lightly attended installation fully. For 
programs that require parameters, your 
application certainly will not be able to 
support unattended installation. 

Response files are ASCII files that 
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a user can freely edit* Each line in the 
file has a maximum length of 255 char¬ 
acters. The most basic unit of a 
response file is the keyvord=value pair. 
For example, the following entries in a 
response file specify the configuration 
values for the maximum number of 
database connections and the database 
buffer size: 


gram more attractive to network 
administrators and users, as well as 
make it easier to ieam and use. 
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Response files can contain key¬ 
word assignments that are specific to 
both installation and configuration. It 
is up to the installation program to 
determine if such a distinction needs 
to be made. This means that the pro¬ 
gram could, for example, accept and 
process all the installation and configu¬ 
ration parameters in a response file 
when the program is first installed* If 
the user or administrator runs the 
installation program again and if the 
program detects that the program 
already exists on the target machine, 
the installation program would still 
use the response file. It would, how¬ 
ever, ignore those parameters that only 
pertained to installation. If the user 
specified a reinstaliation of the pro¬ 
gram, the installation keywords would 
then be used* 

CONCLUSION 

With the explosive growth in LANs, 
users are demanding an easier way to 
configure, install, and distribute their 
applications across all the workstations 
on their LANs. The QD strategy pro¬ 
vides an easy way in which to enable 
applications to participate in the LAN 
environment. You may find it odd that 
many of the features of making your 
product CID enabled are presented as 
recommendations rather than require¬ 
ments. CID was designed to allow 
application developers as much lee¬ 
way as possible in designing their 
products while still being able to par¬ 
ticipate in the CID environment* By 
including these suggested functions in 
your design, you can make your pro- 
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With the increase in demand for workstation disk storage by evolving operating systems, efficient system plan¬ 
ning and hardware investment protection are more critical than ever. The distributed feature option of OS/2 
Communications Manager/2 (CM/2) v. 1.1 can exploit the functions of a LAN-based file server, resulting in sig¬ 
nificantly reduced storage requirements and efficient system maintenance. Here , we overview the distributed 
feature, show examples of installations, and discuss reducing the effects of LAN connectivity losses. 

By STEPHEN SMITH, BRUCE KOHLER, and ADAM KING 


Increasing LAN Efficiency with 
CM/2 Distributed Feature 



r he distributed feature option of 
CM/2 allows multiple distrib¬ 
uted LAN workstations to access 
and run Communications Manager 
from files stored on a single file server 
workstation. The distributed worksta¬ 
tions use a LAN requester facility to 
connect to a designated drive on the 
file server as if the drive (and the files) 
were stored locally* 

Because distributed workstations 
require that only a few CM/2 files are 
installed on a user's workstation, the 
amount of fixed disk space necessary to 
run CM/2 is significantly reduced. 
Workstations that typically would require 
10MB to 15MB for Communications 
Manager files (depending on their 
specific configurations) now need only 
2MB or less with the distributed feature 
arrangement. 

Because the number of distributed 
workstations connected to a single file 
server is limited only by the physical 
LAN installation and the server's 
capacity, the distributed feature option 
can result in a big reduction of LAN 
workstation disk requirements, extend¬ 
ing the useful life of existing limited- 
storage workstations. 

In addition to reduced disk stor¬ 
age, the Distributed Feature option can 
greatly simplify LAN installation and 


maintenance and improve network 
availability The CM/2 product files 
only need to be installed on the server; 
this greatly reduces the cost of distrib¬ 
uting changes and tracking mainte¬ 
nance levels across multiple worksta¬ 
tions* If maintenance is needed, it is 
done at the server, and the worksta¬ 
tions get the benefit of the changes 
with a minimal impact, instead of a 
full CM/2 reinstallation. The distrib¬ 
uted feature also allows you to install 
multiple service levels and national 
language support (NLS) versions of 
CM/2 on a single file server, where 
they can be accessed by workstations 
as needed. 

INSTALLATION AND CONFIGURATION 

The CM/2 Distributed Workstation 
Feature is licensed as a distributed fea¬ 
ture of the OS/2 Communications 
Manager/2 base license* CM/2 pro¬ 
vides the code required to install a file 
server and create unlimited distributed 
feature workstations from the server. 
Each installed workstation needs a sep¬ 
arate distributed feature license. 

Fite Server Installation. There are 
two ways to set up a file server to sup¬ 
port CM/2 distributed feature work¬ 
stations, depending on whether or not 
CM/2 actually executes on the server. 
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Figure 1 . Comparison of standard CM/2 installation vs. dedicated file server with distributed workstations 
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If the LAN administrator does not 
intend to run CM/2 on the file server 
machine, the file server is called a ded¬ 
icated file server, and storage require¬ 
ments are fixed at 20MB. Additionally, 
because a dedicated file server does 
not actually run CM/2, you do not 
need to install OS/2 on the file server 
You can use any LAN-based file server 
(IBM LAN Services, Novell NetWare, 
Banyan Vines, and so on). You can also 
use the CM/2 CMIMIGE utility to install a 
dedicated file server. 

If you want CM/2 to execute on 
the server machine, share the CM/2 
product files between the executing 
CM/2 and the attached distributed 
workstations to limit disk require¬ 
ments. This is a communications file 
server setup, and the installation is 
slightly different. The administrator 
installs CM/2 using the CHSETUP utility, 
specifying the server's operational con¬ 
figuration. Next, the CMSERVER utility is 
used to prepare the operational CM/2 
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Figure 2 . Distributed installation with SNA gateway 
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Function 

Base CM/2 
Workstation 

Distributed 

Workstation 

Interactive Configuration 

YES 

NO 

Runtime reconfiguration 

-Emulator 

YES 

YES 

-SNA/APPC 

YES 

YES 

SNA Services/APIs 

APPN 

YES 

YES 

CPI-C 

YES 

YES 

LUA 

YES 

YES 

SRPI 

YES 

YES 

LU 6.2 

YES 

YES 

Common Services 

YES 

YES 

Emulators 

3270/5250 

YES 

YES 

ASCII* 

YES 

YES 

Connection Types 

LAN 

YES 

YES 

COAX 

YES 

NO 

TWIN AX 

YES 

NO 

Asynchronous 

YES 

NO 

Switched lines 

YES 

NO 

Leased lines 

YES 

NO 

Connectivities 

802.2 

YES 

YES 

SDLC 

YES 

NO 

ASYNC 

YES 

NO 

NETBIOS 

YES 

NO 

X.25 

YES 

NO 

ISDN 

YES 

NO 

Gateway 

YES 

NO 

APPN 

NN/EN 

EN only 

ACDI, ACDI redirection 

YES 

YES 


*The Soffrerm Custom Plus emulator by Softronics Inc. is shipped with 
Communications Manager/2 


Tabfe f. Standard and distributed workstations function availability 


to also act as the file server. 

This mode only requires as 
much disk space as is needed by 
the operational configuration. 
However, the distributed work¬ 
stations can only use files that are 
installed by the operational 
CM/2. Therefore, you need to 
ensure that a superset of all fea¬ 
tures required by the distributed 
workstations is installed on the 
server. Server disks typically 
require 12MB to 20MB, depend¬ 
ing on the features that are 
installed. This configuration 
requires that OS/2 and any LAN- 
based file server that uses OS/2 is 
installed on the file server. 

Following the setup of the 
CM/2 product files on the server, 
the administrator then provides 
an ALIAS for the CM/ 2 libraries 
and provides the distributed 
workstation users with READ 
and EXECUTE authority (assume 
that a LAN requester product is 
installed already on the distrib¬ 
uted workstations.) 

DISTRIBUTED 

WORKSTATION INSTALLATION 

The network administrator cre¬ 
ates Communications Manager 
configuration files that are neces¬ 
sary for the installation of distrib¬ 
uted feature workstations and 
stores them centrally on the 
server. 

Using those configurations, 
workstations are able to access 
the streamlined CM/2 installa¬ 
tion to get the few files necessary 
for running CM/2. As an alterna¬ 
tive, the network administrator 
can install the workstations 
remotely, using the configuration, 
installation, and distribution 
(CID) capability of OS/2, via the 
NetView Distribution Manager/2 
product. 

Although a distributed work¬ 
station does not support the 
CM/2 PM-based interactive con¬ 
figuration utility, the user still 
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can perform run-time configura¬ 
tion changes, such as the modifi¬ 
cation of file transfer profiles and 
keyboard, pop-up keypad, and 
color customization. 

In addition, users can modify 
any Systems Network Architecture 
(SNA) configuration parameters 
that exist in the CM/2 network 
definitions file (NDF) by using an 
ASCII editor and then running the 
CMVERIFY utility. If centralized con¬ 
figuration management proce¬ 
dures are in place, the user must 
send these modified files back to 
the central repository. 

Run-time Functions. Distributed 
workstations have essentially the 
same communications services 
and APIs as a standard CM/2 
LAN-attached workstation. These 
services include IEEE 802.2 for 
communications on the LAN and 
ASYNC support for asynchro¬ 
nous communications device 
interface (ACDI) and ACDI redi¬ 
rection. You can obtain off-LAN 
access via a CM/2 gateway 
machine, a CM/2 advanced peer- 
to-peer networking (APPN) net¬ 
work node, or through another 
network communications con¬ 
troller (37x5, 3174, and so on). A 
distributed workstation cannot 
function as a gateway or as an 
APPN network node. 

Table 1 shows a comparison 
of the available functions between 
a standard Communications 
Manager workstation and a dis¬ 
tributed workstation. 

Other than exception handling 
for a LAN connectivity loss, run¬ 
time execution at a CM/2 distrib¬ 
uted feature workstation is trans¬ 
parent to the user. If CM/2 detects 
the loss of connectivity to the 
server as a result of a break in a 
physical or logical connection, it 
notifies the user that it cannot con¬ 
tinue and terminates. It then per¬ 
forms a cleanup to prepare itself to 
be restarted by the user when con¬ 
nectivity is later restored. 


LAN Connectivity Losses 

Communications Manager/2 is a complex OS/2 application with dozens of 
processes, subprocesses, and threads that run concurrently. Further, in a distrib¬ 
uted feature environment, each workstation typically will have 60 or more files 
opened from the server at any given time. Loss of connectivity to the server in 
this environment can be catastrophic. The CM/2 distributed feature includes a 
LAN loss detection routine to minimize the effects of connectivity losses and 
facilitate recovery from such outages. 

LAN connectivity losses can occur for various reasons. Most typical out¬ 
ages are physical in nature: severed or removed LAN cables, power outages, or 
disconnected remote drives on the distributed workstation. Other reasons for 
connectivity losses include intentional logoff from the server by the user, stop¬ 
ping the requester program while processes that access open server files are 
running, and normal or abnormal termination of server programs. All of these 
conditions can result in failures, ranging from unrecoverable page faults to 
traps, as processes (either active or dormant) that were loaded prior to the out¬ 
age attempt to run in response to an internal or user-driver request. Because 
the operating system doesn't keep track of all the processes and subprocesses 
loaded by each application, the user may not be fully aware of the dormant 
processes still loaded in the system and may believe that the application has 
been terminated. These dormant processes will be subject to the same failures 
once the user attempts to execute the application again. 

The effects of connectivity loss result from the OS/2 classification of net¬ 
work drives as nonremovable, the OS/2 optimization of shared dynamic link 
libraries (DLLs), and the recovery techniques employed by network file systems. 

The nonremovable classification assigned to network drives allows the 
OS/2 loader to assume that executable code loaded from a server will always 
be accessible. This results in reduced swap file growth by allowing the exe¬ 
cutable code to be reloaded from its source rather than copied to the swap file. 
This is why .DLL and .EXE files are locked while they are executing. 

The OS/2 optimization of sharing DLLs further complicates LAN loss recov¬ 
ery. If the application being loaded accesses a DLL that is already being used, 
the OS/2 loader assumes that the DLL can still be read from the disk. This can 
pose a problem when the application is local, and the DLL is located on the file 
server. The locally installed application will load successfully and then experi¬ 
ence the effects of network loss when it attempts to call the shared DLL, which 
is no longer accessible. 

To complicate this sce¬ 
nario, the application may 
successfully call the DLL 
when a portion of that exe¬ 
cutable code is stored in 
the machine's memory. On a 
lightly loaded machine, the 
application could execute 
for hours after a connectiv¬ 
ity loss to the server and 


if normal termination 

delete current PID from shared list 
else 

if network access lost 

request display of failure message 
disable display of fatal trap messages 
for all PIDs in the shared list 
DosKillProcessO 

exit 

Figure 4. LAN loss algorithm 
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may not experience a full toss until it is catastrophic. 

Most network file systems use similar methods of network drive recovery. 
Any lost network drive, once reconnected, has the internal representation of an 
entirely different drive with the same files. The file system loader, when called 
on to reread an executable file, detects that the file cannot be read from its 
original location and fails. Although the network drive appears the same to the 
user (same drive letter and files), the loader knows that the original cannot be 
accessed. Consequently, any process that is loaded from the reconnected net¬ 
work drive will fail as if that drive had never been reconnected. 

The LAN loss function provided by CM/2 attempts to reduce the 
effects of connectivity loss. It does this by using the OS/2 capability of 
registering a subroutine to be run at program termination. This exit list 
processing is supported for OS/2 1.3 and OS/2 2.x. The exit list routine is 
stored in a DLL that is always installed locally to ensure access in the 
event of a LAN connectivity loss. Each Communications Manager/2 
process and all user processes that access Communications Manager/2 
via an API link to the DLL directly or indirectly. 

The DLL initialization routine registers an exit list routine in all the 
processes and stores the process identifiers (PIDs) in a shared memory 
area. As each process exits, the routine is notified if the process has ter¬ 
minated normally or abnormally. 

In the event of abnormal termination of a CM/2 process, CM/2 
checks the accessibility of a file known to reside on the file server; if the 
file cannot be accessed, the connection is assumed to be lost. Abnormal 
termination in the event of LAN connectivity loss is usually the result of a 
fatal page fault. This basic algorithm is described in Figure 4. 

Communications Manager/2 LAN loss processing proceeds as 
follows: 

1. A request to display a message indicating that CM is terminating due 
to LAN loss. 

2. The shared memory list of process identifiers is accessed and a 
DosKiUProcessO is issued for each one. 

3. The OS/2 fatal page fault message is suppressed. If the loss occurs in 
a system-wide debugger environment such as the OS/2 debug kernel, 
the fatal page fault is seen as trap 000E. 

All user processes are left running unless they attempt to access 
unavailable .EXE or .DLL files, in this event, they are stopped individually by 
OS/2 as they fault. If the network is restored using the methods employed 
by most network file systems, the user must stop each process before 
attempting to restart CM/2. CM/2 provides the productivity aid CMPROC.EXE 
to help identify and terminate user processes that have attached to CM/2. 

Very few network file systems provide an active notification of LAN 
loss. As an alternative, you can poll for file server accessibility or adopt a 
passive detection system, as CM/2 does. Polling wastes CPU cycles and 
network bandwidth checking for a low frequency event and fails to rule 
out the opportunity for network loss failure without detection completely. 


SAMPLE DISTRIBUTED 
INSTALLATIONS 

Three examples of distributed fea¬ 
ture installations highlight the dif¬ 
ferent installation approaches that 
are available. 

Dedicated File Server with 
Distributed Feature. In Figure 1, the 
example compares a standard 
CM/2 installation with a distrib¬ 
uted feature installation using the 
same equipment. We compare 
disk requirements for each type 
of installation. 

In Figure 1, a LAN file server is 
assumed to already exist on the 
LAN. 

Communications File Server 
Acting as a Gateway. The example in 
Figure 2 shows a distributed fea¬ 
ture network in which the file 
server also acts as an SNA gateway 
attached to a wide area network. 

Multiple Language and Version 
Installation. The example in 
Figure 3 shows how you can 
install multiple national language 
versions or CSD upgrades of 
CM/2 on a single file server and 
access them across the LAN. A 
multiple language setup is useful 
for sites that require multilingual 
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installations, such as corporate 
training facilities or travel reser¬ 
vation companies. If you have 
multiple CSD levels available 
concurrently, it facilitates service- 
level testing prior to distribution 
throughout the network. 
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information developer with IBM's 
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the Systems Software and Development 
Services organization of the Networking 
Software Division, Research Triangle Park, 
N.C. Most recently, he was responsible for 


The passive method employed by CM/2 is more efficient but leaves the pos¬ 
sibility of experiencing the effects of LAN connectivity loss without detecting 
the source of the problem. Failure without detection can occur when network 
access is lost and restored while CM/2 is only executing code that is stored 
in memory. The result is a series of inexplicable traps. To restore normal 
operation, the user can run CMPRDC.EXE to stop all CM/2 and user processes 
or reboot. Most occurrences will be detected, CM/2 will be stopped, and the 
user can stop all transaction programs, possibly saving user data. When file 
server access is restored and all processes are stopped, CM/2 can be 
restarted without a complete system reboot. 


the testing of the distributed feature option 
of OS/2 Communications Manager/2 and 
has held other lead testing roles for CM/2 
since 1990. Kohler joined IBM in 1974 and 
holds a B.S. in computer science from 
Pennsylvania State University. 


Adam King is a developer with IBM's 
Networking Software division in Research 
Triangle Park, N.C. He has been with IBM 
since 1991 King holds a B.S. in computer sci¬ 
ence from Furman University and an M.S. in 
computer science from Clemson University. 
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New Tools and Utilities 


TOOLS 

Footprints 2,0. A real-time trace facili¬ 
ty for 16-bit and 32-bit applications 
running OS/2 2.x, Footprints 2.0 allows devel¬ 
opers to trace and debug code in real time, with¬ 
out the need to stop or slow the program down, 
according to the company. Footprints only traces 
when embedded trace switches are activated 
from an external PM interface* It can also create 
time-stamped archive files of traced data and 
paths of execution. Once the developer-defined 
trace statements are compiled into the code, their 
switches can be turned on and off without 
recompiling. Footprints 2.0 is priced at $99,00. 

Hardy Software Systems Inc. 

Phone: (713) 871-1448, Fax: (713) 871-1449 

GpfRexx. GpfRexx is a visual programming 
environment that allows OS/2 users to design, 
test, and generate Presentation Manager graph¬ 
ical user interfaces for programs in REXX. A 
point-and-click interface design tool set, 
GpfRexx lets even users without detailed sys¬ 
tem-level knowledge design, test, and generate 
user interfaces that take advantage of OS/2 fea¬ 
tures, the company says. Users point and click 
to design interface windows, menus, and GS/2- 
style, context-sensitive and extended help. 
GpfRexx requires OS/2 2.1, a mouse; at least 
6MB of available hard disk and SMB of RAM 
are recommended. GpfRexx costs $247.50. 

Gpf Systems Inc. 

Phone: (800) 831-0017 or (203) 873-3300, 

Fax: (203) 873-3302 

VisPro/REXX 2.0. VisPro/RFXX Bronze 2.0 and 
VisPro/REXX Gold 2.0, which make up version 



2.0 of the VisPro/REXX product set, are visual 
programming tools for building OS/2 2.x GUI 
applications. The new version includes support 
for creating visual REXX macros, adding objects 
using IBM's SOM, and accessing the Q+E Data¬ 
base Library. VisPro/REXX Gold 2.0, which 
replaces the original product, features built-in 
entity/relationship database diagramming. Vis- 
Pro/REXX Bronze 2.0 is priced at $99.00; Vis¬ 
Pro/REXX Gold 2.0 is $299.00, 

HockWare Inc. 

Phone: (919) 380-0616, Fax: (919) 380-0757 

Enhanced Printer Driver Tool Kit for OS/2. The 

Enhanced Fax Printer Driver helps users write 
applications that create and send fax docu¬ 
ments, or add fax to existing applications. By 
printing ASCII text to the printer driver, users 
can create and send fax documents, according 
to the company. Command lines convert text 
using different fonts, add cover pages and 
header lines, and automatically send the fax 
document. Users can broadcast faxes to lists of 
recipients. The printer driver is compatible 
with SofNet's FaxWorks OS/2 products and 
Keller Group's PMfax products. Enhanced 
Printer Driver Tool Kit is available for $295.00. 

Keller Group Inc. 

Phone: (612) 429-7273, Fax: (612) 653-1987 

WidgetKit/CUA '91. WidgetKit/CUA'91 adds the 
CUA'91 controls to the standard controls avail¬ 
able for use in Window Builder Pro/V. Win- 
dowBuilder Pro/V enables programmers to 
build user interfaces interactively and rapidly, 
according to the company. WindowBuilder 
Pro/V with WidgetKit/CUA'91 provides a 
CUA interface development environment for 
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UTILITIES 


SmaUtalk/V OS/1 WidgetKit/CUA'91 has an 
implementation of the IBM CUA'91 controls, 
including notebook, container, slider, value set, 
and spin button. It is priced at $295.00. 

Objectshare Systems Inc. 

Phone: (408) 727-3742, Fax: (408) 727-6324 

CA-SuperProject for OS/2. A multiple project man¬ 
agement tool, CA-SuperProject exploits such 
OS/2 features as the Workplace shell, preemp¬ 
tive multitasking, and enhanced memory man¬ 
agement. According to the company, CA-Super- 
Project contains ease-of-use features, including 
Help Assist mode, experience modes, pop-up 
forms, and Project Manager's Assistant; views, 
including four outlines with Gantt and his¬ 
togram charts and crosstabs; project modeling, 
featuring effort-driven scheduling, flexible data 
and precedence constraints, and work break¬ 
down structure; and resource management and 
costing. CA-SuperProject for OS/2 is compatible 
with Windows 3.1 and OS/2 2.1 and is bundled 
with the Windows version at a price of $649.00. 

Computer Associates International Inc. 
Phone: (516) 342-5224, Fax: (516) 342-5329 

Automated Test Facility 3.0. Automated Test Facil¬ 
ity (ATF) 3.0 tests client/server applications 
written under Windows and OS/2. ATF's 
architecture, which features a central point of 
control, is capable of testing multiple worksta¬ 
tions interacting simultaneously. This enables 
ATF to test client/server scenarios for concur¬ 
rent requests and lockout, as well as more com¬ 
plex cases in which the results of one user's 
activities may trigger the tasks of other users. 
With this new version, users can incorporate 
legacy system testing through AFT's new sup¬ 
port for 3270 terminal emulation. Other features 
include a capture/playback facility and script¬ 
ing language. ATF prices, depending on test¬ 
ing configuration, start at $18,000.00; this pro¬ 
vides the central point of control and the ability 
to test applications on one workstation. Each 
additional workstation costs $2,000.00, 



CPU Monitor Plus. CPU Monitor 
Plus is a utility that provides 
graphical and text displays of CPU Utilization 
for processes and threads and RAM utilization 
estimates for processes including detailed 
analysis of allocated, in-use, private, and 
shared totals. It also allows users to change 
execution priority or suspend individual 
threads in OS/2 Presentation Manager appli¬ 
cations. CPU Monitor Plus is priced at $129.95. 


BonAmi Software Corp. 
Phone: (508) 371-1997 


Sterling DMS/IB for OS/2. Sterling DMS/IB is a 
backup utility that supports extended attributes 
including long file names; works with FAT or 
HPFS or both; runs as a background process; 
runs from command line or Presentation Man¬ 
ager text box; and supports SCSI-2 tape devices. 
Sterling DMS/IB is priced at $180.00. 

Sterling Software 

Phone: (916) 635-5535, Fax: (916) 635-5604 
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(312) 644-6610 
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June 23-25 
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Computing, Chicago 
(202) 457-8700 

July 19-22 

OS/2 World, 

Santa Clara, Calif. 

(415) 905-2354 


Softbridge Inc. 

Phone: (617) 576-2257, Fax: (617) 864-7747 
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ADVERTISER INDEX 


ODBC or NOT? 
That's the question. 

E ver wonder if ODBC really means "Only Does 
Basie Connectivity" or if Q+E stands for 
"Questionable + Expensive"? If so, join the crowd 
of programmers who have discovered the true 
meaning of Open DataBase Connectivity. 

S QL Objects++ is the answer. 

The exploding Client/Server market has everyone 
searching for a database access method to hang their 
hat on. Unfortunately, all of these methods limit you 
to the lowest common denominator. With the release 
of version 2 of SQL Objects + + "you can have your 
cake and eat it too." 


Don't base your application or future on a "one 
access" solution. Use a solution that allows you to 
access your database any way you like. Use a 
solution that is designed for performance. Use a 
solution that handles multiple operating systems 
with the same set of cotie. Use SQL Objects+ +. 


C+ + - Object-oriented 
OS/2-Wmdows-NT-DOS-UNIX 
SQL Objects + + Enabled Application 
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NEW SQL Objects++ Version 2 


Oracle 

DB 2/2 

Btrieve 

DB2/6000 

Sybase 

SQL Base 

ASCII/B inary 

D DCS/2 

SQL Server 

Netware SQL 

Watcom 

Others... 


We have a lot more to tell you but there's not 
enough room. So, pick up the phone right now and 
call 800-876-6585 for more information. 
Better yet, call and ask about our "No Risk 
(Really!) Guarantee" and our "$99 Test Drive" 
option. 

Qbjects++ ; 

SOFTWARE CORPORATION 
47 Stonewall Street Cartersville, GA 30120 
(404) 382-6585 - fax (404) 382-6374 

SQL Objects + + and Inherit The IWrr are trademarks of Objects + + Software Carpomlion. 
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Visual programming is currently a hot issue in the desktop marketplace. This article demonstrates a 
visual programming tool in a sample-intensive manner, based upon a recent job assignment by one of 
the authors. By MARK A. BENGE, JOHN BOEZEMAN, and JAMES PIRKLEJR. 


Visually Sampling 
DB2/2 


s OS/2 gains acceptance in the 
marketplace, tools that promote 
application development for the 
operating system continue to arrive on 
the scene. One such tool uses a visual 
interface for program construction* Visual 
programming tools are designed to 
encourage rapid creation of applications. 
Our goal is to provide a sample-intensive 
article that highlights the strengths of 
visual programming. 

We based part of the article on a pro¬ 
gramming assignment that James Pirkle 
recently completed for his client, R.J. 
Reynolds Inc* We demonstrate how easy 
it can be to generate an application that 
will query DB2/2 or, more specifically, 
access the sample database that ships 
with DB2/2* We will use Hockware's 
VisPro/REXX v. LI to generate our DB2/2 
sampling application* Additionally, we 
will show you how to use one of the new 
DB2/2 support features in the latest ver¬ 
sion, VisPro/REXX v. 2*0 Gold Edition. 

BACKGROUND 

VisPro/REXX is tightly integrated with 
the Workplace Shell* If you're familiar 
with the Workplace Shell, the develop¬ 
ment environment will be highly intu¬ 
itive. Direct manipulation (Drag&drop) is 
used extensively in the development of 
applications. Additionally, as the name 


implies, the product incorporates the 
OS/2 REXX programming facility* 
However, as you will see in our sample 
application, you do not have to be a 
REXX guru to use the product. Table 1 
provides definitions of the terms that we 
use throughout the article. 

SAMPLE APPLICATION 

Our sample application, called DB2/2 
Sampler, illustrates the use of various 
OS/2 GUI controls; the notebook, listbox, 
entry field, push and radio buttons, and 
valuesets. You can obtain the source code 
for DB2/2 Sampler from the electronic 
sources listed in the references box on 
page 88. We will cover the various steps 
we followed to create DB2/2 Sampler 
using VisPro/REXX, so you can reference 
them. 

CREATING A PROJECT 

Our first task is to create a new project 
and forms for all of the DB2/2 Sampler 
windows. The project will encapsulate all 
the forms required by the sample applica¬ 
tion* Figure 1 contains these steps. 

INITIALIZING AND 
ADDING NOTEBOOK PAGES 

Notebook pages in Vispro/REXX are 
really just another form that you add 
to the form you have designated as a 
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Event 

Occurrence that prompts behavior 


Behavior 

Function that a form or object performs 


Object 

A graphical representation of a control or controls 


Project 

A logical unit of operation such as the sample application 


Form 

Environment in which the application is designed 


Canvas 

Area in Layout view in which you add objects to the form 



Table 1 Terms used throughout the article 



* From the VisPro/REXX PROJECTS folder, drag and drop the Projectfolder template, which will cause a new 
project to be created. 

* Direct Edit the new project folder and change the name to Demo. Open the Direct Edit window using a 
combination of the <Alt> key and mouse button L Close die window by clicking outside of the window* * 

* Open the Demo folder by double clicking on it with mouse button 1, 

* Create the notebook, the two notebook pages, and the DB2/2 Query form. 

i) Drag&drop the Form template within the Demo folder. This will create a new form* Repeat this three more 
times. 

ii) Change the names of the new forms to Notebook, Colors, Fonts, and ShowDept. 

Figure l Creating a new project 


• Open the Fonts form, which will start VisPro/REXX, 

• Choose the Open -> Settings menu item from the context menu on the canvas (click with mouse button 
2 on the canvas to bring up the context menu), 

• Select the Notebook page radio button and dose the settings dialogue* 

• Drag&drop a radio button object to the canvas. 

• Change the text of the radio button to Courier 12pt. Repeat this step for the second Hdv 18pt radio button. 

• Double click on the top radio button. This will bring up the settings notebook for the radio button. 

• Select group and dose the dialogue window. Both radio buttons will be added to the same group if 
the group style is added to only one of them. As a result, only one of the radio buttons can be 
selected at a time* 

• Select the Event tree view menu item from the View menu pulldown. 

• From the context menu for the Courier radio button, select the When -> Clicked/selected menu item. 

• Open the context menu on the edit region (window on the right). From the context menu, select Add *> 
Window management -> Notify source window, as illustrated in Figure 3* This will generate the following line: 

CALL VpNotify window, 'message/ 

• Change message to FONT 12. Courier. This call will cause a text message to be sent to the parent of this 
window, which will be the notebook. 

• Repeat the prior two steps for the FONT 18,Helv radio button. 

• Save the Event tree view. 

• From the Form menu pulldown, select Create link, which copies the REXX command for loading this 
page into the clipboard. 

• Close the Fonts form. 


Figure 2. Initializing Fonts page 
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Size/position window 
Get window size 
Get window position 
Set window title 
Notify source window 
Close window 



Figure 3. Source window notification step 


* Open the Notebook form, 

* Drag&drop a notebook to the canvas, 

* Select the When -> Opened* *., submenu from the Form menu. 

* From Edit menu on the Event window select Paste, which will put the REXX command that was copied 
into the clipboard, as shown in Figure 2, in the Event window. This statement will open the Font form 
when we test DB2/2 Sampler. 

* Drag&drop the notebook from the canvas to the Event window. This will bring up the Create Link 
dialogue, 

* Select the Add notebook page item, and change the word title to Fonts. This statement will add the Fonts 
form to the notebook as a page. 

* Save and close the Event window and the Notebook form. 

Figure 4, Adding Fonts page 


notebook. We will show you how 
to initialize and add a page to a 
notebook in this section. 

The Fonts notebook form is used 
to represent a notebook page that 
will allow selection of two different 
fonts in DB2/2 Sampler. Radio but¬ 
ton controls will be placed on the 
page to allow selection. Figure 2 
lists the steps required to initialize 
the Fonts page. 

Once the Fonts page is initial¬ 
ized, it is ready to be added to the 
Notebook form. Figure 4 lists the steps 
required to add the Fonts page. 

The Colors notebook form is 
used to represent a notebook page 
that will allow selection of eight 


different background colors in 
DB2/2 Sampler. A valueset control 
will be placed on the page to allow 
selection. Figure 5 lists the steps 
required to initialize the Colors 
page. 

Once the Colors page is initial¬ 
ized, it is ready to be added to the 
Notebook form. Figure 6 lists the 
steps required to add the Colors 
page. 

DISPLAYING DATA 

FROM SAMPLE QB2/Z DATABASE 

The Show Dept form is used to display 
data in the sample DB2/2 database 
that ships with DB2/2. Text fields 
are created on the form to display 
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data. Figure 7 lists the steps 
required to initialize the form. 

THE MAIN FORM 

The Main form is the form initially 
displayed when a VisFro/REXX 
application is invoked. Besides ini¬ 
tializing the form, REXX code must 
be added in order to register the 
SQL dynamic link libraries (DLLs) 
and start using the sample DB2/2 
database. 

Due to space constraints and 
the lengthy steps required to ini¬ 
tialize the Main form, we provide 
this information in a README file 
that is part of the source code file 
that you can download. Specific 
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* After opening up the Colors form and changing it to a notebook page, drag&irop a valueset object to the 
canvas, 

* Open the Settings notebook for the valueset control. 

i) Change the number of horizontal cells to 2 and the number of vertical cells to 4, so there will be a total 
of eight cells, 

ii) Select the RGB color radio button, and close the Settings view. 

* Select the When -> Opened,,, submenu from the Form menu. 

* Drag&drop the value set object from the canvas to the Event window and the Create Link listbox will 
appear, 

* From the listbox, select Set cell value. 

* Highlight the generated REXX statement and copy it to the clipboard by selecting the Copy menu item 
from the Edit menu. 

* Paste from the clipboard seven of these statements into the Event window, by selecting the Paste menu 
item from the Edit menu. 

* Replace the respective variable value with the following: 0* * 16777215, 255, 16711680, 65280, 16776960, 65535, 
16711935, 

* Next replace the row, column variables with 1,1 2,1 3,1 4,1 1,2 2,2 3,2 4,2. 

* Save and close the Event window, 

* Open the Event tree view, 

* Select the When -> Clicked/selected option in the context menu, 

* Dragftdrop the valueset over to the edit region. 

* Select Get item value from the listbox. 

* Open the context menu on the edit region and select Add -> Window management -> Notify source window. This 
will generate the following line: 

CALL VpNotify window, 'message' 

Change the message to COLOR value. This call will cause a text message to be sent to the parent of this win¬ 
dow, which will be the notebook, 

* Save the Event Tree View. 

* Select Create link from the Form menu, 

* Close the Colors form. 

Figure 5 , Initializing Colors page 


* Open the Notebook form. 

* Select the When *> Opened menu item. 

* From Edit menu on the Event window select Paste, which will put the REXX command that was copied 
into the clipboard, as shown in Figure 4, in the Event window. This statement will open the Colors 
form. 

* Dragftdrop the notebook from the canvas to the Event window. 

* Select the Add notebook page item and change the word title to Colors. This statement will add the Colors 
form to the notebook as a page. 

* Save and close the Event window. 

* Select the When -> Secondary notify. ,. menu item from the Form menu. 

* Add the word Parse before the word Arg in the Event window. 

* Open the context menu and select Add -> Window management -> Notify source window and change message in the 
resultant REXX statement to message. 

* Save and close the Event window. 

* Save and close the Notebook form. 

Figure 6. Adding Colors page 
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Figure 7. Initializing ShovDept form 


information on the file is in the 
reference box on page 88. 

SUBROUTINES 
PROCEDURES (SUBPROCS) 

SubProcs are segments of REXX code 
that can be shared by events within 
a VisPro/REXX application. 

Additionally, they are created 
with the editor of your choice, the 
only stipulation being that they 
reside in the XXX\SubProcs subdi¬ 
rectory, where XXX is the name of 
your project. 

Three SubProcs are defined for 
the DB2/2 Sampler application, 
and they provide the following 
services: 

* SELSTAFF formats and adds staff 
information to the listbox on the 


Main form. 

* SELDEPT formats and displays 
selected department information. 
» OPENDB registers SQL DLLs and 
connects to the DB2/2 database. 
The source for the three 
SubProcs can be obtained from the 
electronic sources listed in the ref¬ 
erences box on page 88. 

TESTING DB2/2 SAMPLER 

Finally, we are ready to test 
DB2/2 Sampler. To test the appli¬ 
cation, select the Test menu item 
from the Form menu on the Main 
form. 

If things didn't turn out the 
way you planned them, make 
modifications or refer to the sam¬ 
ple source code. 


In Figure 8, we illustrate a 
test session. In this illustration, 
the Open Settings notebook has 
been opened. 

BUILDING AN 
EXECUTABLE PROGRAM 

If everything works as you desire, 
you can build an executable pro¬ 
gram by selecting the Build menu 
item from the Form menu on the 
Main form. 

NEW DB2/2 SUPPORT 
IN VISPRO/REXX V.2M 

As you can see, a great deal of 
our time is spent adding REXX 
code to perform the queries to 
the sample DB2/2 database. If 
this code were generated for us. 
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Figure $. Testing DB2/2 Sampler 


• Create a diagram by dragging one off of 
the VisPro/REXX database diagram 
template. 

• Open the diagram. 

• From the DataBase menu, select the Reverse 
Engineer menu item. 

• Select the SAMPLE database from the listbox, 
click on Find Qualifiers, select USERID from 
the listbox, and click on OK, The sample 
database window appears as shown in 
Figure 10. Observe how the diagrammer 
has identified the referential constraint 
relationship between the STUFF and ORG 
tables. 

• Highlight the ORG table object. From its 
context menu, select Selected -> Open 
Settings. When the Open Settings notebook 
appears, select the Attributes tab and the 
notebook page shown in Figure 11 will 
appear. 

Figure ft Reverse engineer 



Figure 70. Referential constraint relationship 


not only would we immediately 
become more productive, we 
would reduce the size of the 
maintainable code base, which is 
a blessing to those whose task is 
program maintenance. 

The database support fea¬ 


tures that are in VisPro/REXX v. 
2.0 Gold Edition are a logical 
extension to the v. 1.1 product If 
you're comfortable with the 
work we've done here, the fol¬ 
lowing information will be easy 
for you to digest. 


PREPARING THE SAMPLE DATABASE 

To generate a form to access a 
DB2/2 table, the reverse engineering 
tool requires the table to have a pri¬ 
mary key. To add primary keys to 
the ORG and STAFF tables, you can 
enter the following commands at 
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Column name 

Mime 


DEPTNAME 

DEFTKUME 

DIVISION 

LOCATION 


VCHAR N Y 
SINT Y N 
VCHAR N Y 
VCHAR N Y 


MANAGER 


Add j | .Change | 


Character 


LJErimarv key [J Create index 
[_jQan be null Unique 
jJlext 
Maximum 


Length 

Precision 


3 Settings View 


Qeneral 

Attrihute J 


Figure 11. ORG table attributes 


DB2/2's command line interface (we 
also added a foreign key to the STUFF 
table to illustrate VisPro/REXX's 
Database Diagrammer): 

1. STARTDBM 

2. LOGON userid /P;password 

3. DBM CONNECT TO SAMPLE 

4. DBM ALTER TABLE ORG PRIMARY KEY 
(DEPTNUMB) 

5. DBM ALTER TABLE STAFF PRIMARY KEY 
(ID) FOREIGN KEY FOR.DEPT (DEPT) 
REFERENCES ORG ON DELETE RESTRICT 

REVERSE ENGINEERING 
THE SAMPLE DATABASE 

Since the sample database already 
exists, we can take advantage of 
one of the new features that will 
allow us to reverse engineer the 


sample database. Reverse engi¬ 
neering will display the structure 
of the database in a graphical for¬ 
mat. The steps required to reverse 
engineer are listed in Figure 9. 

WE MAIN FORM REVISITED 

In the previous sections that dealt 
with the Main form and SubProcs, 
many steps were taken to ensure 
that all the REXX code was in place 
to query the sample database. The 
steps illustrated in Figure 12 replace 
many of the steps required to ini¬ 
tialize the Main form and all of the 
REXX code entered for the three 
SubProcs, which is not required in v 
2*0. As you will see, the time and 
effort required to create applica¬ 


tions by reverse engineering exist¬ 
ing databases and Drag&drop is con¬ 
siderably less than what is required 
to build similar applications by tra¬ 
ditional programming techniques. 

The steps in the Main form that 
are not replaced involve adding the 
Open Settings pushbutton and creat¬ 
ing a link to the Notebook form, so it 
will be opened when a user dicks on 
Open Settings* Also, the links required 
to change the Font and Color will 
need to be implemented based upon 
the new DB2/2 support. 



CONCLUSION 

Visual programming encourages 
rapid prototyping and application 
development. When compared to a 
conventional command prompt 
development environment, the 
time savings can be measured in 
hours or even days* However, the 
pace does slow when you are 
required to enter code to add sup¬ 
port that is not present in the 
visual programming tool. As the 
state of these tools advance, so 
does their functionality. 

In the section. New DB2/2 
Support in VisPro/REXX v. 2.0 , we 
looked at a recent enhancement to 
the visual programming environ¬ 
ment* VisPro/REXX not only 
saved time, but wear and tear on 
the keyboard* Unfortunately, we 
could only cover the reverse engi¬ 
neering portion of the Visual 
Database Designer enhancement, 
which can also be used to design 
DB2/2 databases from scratch* 


* Open the Main form* 

• Qragftdrop the ORG table object onto the Main form. The Create Database Link dialogue will appear, as shown in 
Figure 13* Use all of the columns and action buttons, which are already selected by default, by clicking on 
the OK button. 

* Save the Main form* 

• Test the demo application by selecting the Test menu item from the Form menu, and the test dialogue as 
shown in Figure 14, will appear. Note the support that allows you to Add, Delete, Change, and Search rows* In 
the DB2/2 Sampler application, additional code is required to perform these tasks, whereas a simple 
checkbox selection generates the code for us in v* 2*0 release* 

Figure 12. Revisiting the Main form 
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Figure 13. Create database link dialogue 
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Figure 14. Testing DB2/2 Sampler using new DB2/2 support 
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The source code can be downloaded from several electronic sources: 

• In the U.S., call the IBM PCC BBS at (919) 517-0001. The source code 
for this article is in File Area 11 under the name VPRDB2.EXE. 

• On CompuServe, the source code is in LIB13 of the OS2DF2 forum, 
under the name VPR0B2.EXE. 

• If you're an IBM TALKLINK customer, the source can be down¬ 
loaded from the OS2BBS. 

• If you have a VM account on an IBM node, get the source code with 
the command REQUEST VPRDB2 PACKAGE FROM BANZAI AT CARVH3. 
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The staff of OS/2 Developer put together this special section to guide you through the various LAN development 
tools available for OS/2. The products described in this guide are based on surveys sent to vendors; they are 
provided as a service to you and are free to vendors. These listings do not represent an endorsement by OS/2 
Developer. Although every effort has been made to ensure accuracy, we do not assume any responsibility for 
error or omission in this section. Please contact the companies directly for more information. 

LAN Development 
Tools Buyer's Guide 


ANDERSEN CONSUL TING- 
FOUNDATION ORGANIZATION Circle No, W1 

FOUNDATION for Cooperative Processing 20 provides orga¬ 
nizations with the methodology, application development 
tools, and enablement services for building liigh-end and 
enterprise-wide client/server systems. FCP contains 
FOUNDATION Design, FOUNDATION Production, and 
FOUNDATION methods, all of which are integrated via 
the repository and are supported by enablement services. 
Price: Please contact vendor 

Andersen Consulting—Foundation Organiza¬ 
tion, 69 W. Washington, Chicago, Ill. 60602, (800) 
458-3851 or (312) 507-5161, fax (312) 507-2548. 

CAPSTONE SOFTWARE INC. Circle No. 102 

SpaceMap 1.0 for OS/2 is a native 32-bit PM application 
that analyzes disk space usage at the directory and file 
level It summarizes space used by subdirectories and pro¬ 
vides file-search, management, and archival facilities. 
SpaoeMap also solves insufficient space problems. It mea¬ 
sures LAN application space usage and helps you manage 
overcrowded LAN drives. Price: $49.95, 

Capstone Software Inc., P.O. Box 416, Carmel, 
Ind. 46032, (800) 500-2244 or (317) 848-2414, fax 
(317) 582-0454. 

CFSOFTWARE INC , Circle No, 103 

pcMAINFRAME 4.3 \s a data transfer software package for 
PCs and mainframes. It selects, extracts, reformats, and 
downloads or uploads data to and from PCs and main¬ 
frames into existing applications. It offers four levels of 
security and many selection capabilities. Dialog, a built-in 
scripting facility, allows users to automate tranfers. 
pcMAINFRAME allows authorized CICS network users 
to access the data they need, PC requirements: OS/21.2 or 
3.0. Price: $9,000+. 

Across the Boards 3.11 is an application pro¬ 
gram interface to communications devices for the 
IBM PC. It aids you in developing applications that 
are cooperative between mainframes and PCs. You 
can develop applications with the following levels 


of Across the Boards: DIALOG, a scripting facili¬ 
ty/terminal emulator; XAPI, a universal 3270 API; 
and APPX, a peer-to-peer communications facility. 
Each level may be purchased separately. Price: 
$7,000+. 

cfSOFTWARE Inc., 2454 E. Dempster, Ste, 201, 
Des Plaines, III 60016, (800) 366-8756 or (708) 824- 
7180, fax (708) 824-0930, 

CLIENT SERVER 

NETWORKING INC. Circle No. 104 

WATCHIT 10 automates collection of LAN SERVER 3.0 
capacity and performance data. It allows you to analyze 
mean response times, bytes transferred, print jobs, buffer 
allocations, as well as users logged on and resources 
shared. Charts and graphs help you to make decisions to 
improve server performance. Certified "Ready! for LAN 
Server" and "Ready! for OS/2." Price: $299 per server. 

CONDUIT 2.0 is a network-independent LAN 
file distribution system for installation, upgrade, 
and version control on any number of networked 
DOS or OS/2 clients. It creates directories, remotely 
executes programs, and maintains inventory data. 
Collected profiles allow you to reconstruct system 
files. Certified "Ready! for LAN Server." Price: $299 
per server. 

Client Server Networking Inc., P.O. Box 
370111, West Hartford, Conn. 06137-0111, (203) 
233-2951, fax (by arrangement) (203) 233*2951. 

COMPUTER ASSOCIA TES 

INTERNA TIONAL INC Circle No . 105 

CA-Realizer 2,0 is an OS/2-based visual application devel¬ 
opment tool. Using BASIC as its core language, CA-Real¬ 
izer provides a development environment for client/serv¬ 
er, LAN, departmental, or single user applications. You 
may distribute applications built with CA-Realizer free of 
royalty or license fees. CA-Realizer is compatible with 
OS/2 2,1 or higher. Price: $99, until March 31,1994; $247, 
after March 31,1994, 

Computer Associates International Inc., One 
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Computer Associates Plaza, Islandia, 
N.Y. 11788-7000, (800) 225-5224 or (516) 
225-5224, fax (516) 342-4864. 

DEVELOPMENT 

TECHNOLOGIES INC. Circle No. 106 
DeskMan/2 1.2 helps you to manage Work¬ 
place SheU desktops and objects locally and 
remotely. It also allows you to authorize 
access to individual DeskMan/2 features on 
a user-by-user basis. Deskman/2 l s features 
include security and window management, 
GUI and API to manipulate WPS objects, and 
configuration and desktop snapshot facility. 
It is network-enabled, including CID and 
LAD/2. Price: $79.95 (street price varies). 

Development Technologies Inc., 
308 Springwood Rd., Forest Acres, S.C. 
29206-2113, (803) 790-9230, fax (803) 
738-0218. 


EASEL CORP Circle No. 107 

ENFIN 29 is an object-oriented development 
toolset for Windows, OS/2, and UNIX. It 
delivers reusable applications that can be 
deployed across a multiplatform network. 
Price: Please call. 

Easel Corp., 25 Corporate Dr., 
Burlington, Mass. 01803, (800) 759-5880 
or (617) 221-2100, fax (617) 221-6899. 

EICON 

TECHNOLOGY CORP Circle No. 108 

APPC Application Subsystem t.OOior OS/2 sup¬ 
ports off-the-shelf applications written to the 
IBM Communications Manager/2 APPC 
specifications. It works with the Eicon Tech¬ 
nology SNA LAN Gateways (DOS, OS/2, 
and NetWare servers) and the SNA PC Gate¬ 
way for OS/2. It provides an interface for ses¬ 
sion management and administration and 
allows user programs to establish peer-to- 
peer sessions with other PCs, midrange com¬ 
puters, and mainframe computers. Price: 
$195+, depending upon numbers of users; 
$3,750 for LAN Gateway Pack. 

SNA Function Management Develop¬ 
er's Toolkit 1.00, through an Eicon Tech¬ 
nology SNA Gateway, allows PC or 
PS/24iased applications to set up Appli¬ 
cation-Application (LU-LU) simultane¬ 
ous sessions with an SNA host, includ¬ 
ing IBM S/370, System/3X and AS/400 
computers. It provides an interface for 
the SNA protocol stack, using a library 
of C function calls. Price: $1,000. 

EiconAPPC Developer's Toolkit 2.00 
for OS/2 facilitates the development of 
OS/2-based communications applica¬ 
tions based on the IBM LU 6.2 protocol. 
Using a library of C function calls to 
provide a high-level interface to the 
SNA protocol stack, it allows develop¬ 
ers to design programs that interact on 
a peer-to-peer basis with other local or 
remote applications on an SNA/APPN 


network. Other applications can be run¬ 
ning on other personal computers as 
well as any minicomputers or main¬ 
frames supporting APPC. Price: $1,000. 

Eicon Technology Corp., 2196 32nd 
Ave., Lachine, Quebec H8T3H7, Cana¬ 
da, (514) 631-2592, fax (514) 631-3092. 

GATEWAY 

SYSTEMS CORP Circle No. 109 

SYNERGIST Application Development System 3.6 

is a client/server application development 
tool that integrates PCs with IBM, HP, and 
DEC hosts. It helps you to develop on-line, 
transaction-based applications that execute 
on the PC and access existing databases, PC 
databases, or both. You can use SYNERGIST 
to develop order management, distributed 
processing and sales force automation appli¬ 
cations. Price: Please call. 

Gateway Systems Corp., 4660 S. 
Hagadorn Rd., Ste. 110, East Lansing, 
Mich. 48823, (800) 333-9366 or (517) 337- 
8960, fax (517) 337-2868. 

GILMORE SYSTEMS Circle No. 110 

Magnum BBS 7.00c is a customizable electronic 
BBS for OS/2 with file transfer, electronic e- 
mail, CD-ROM support, offline messaging, 
and RJE (background) program execution. 
You can use it as a modemless LAN-based 
BBS or LAN-based e-mail system. It supports 
OS/2 and DOS client workstations. Price: 
$75-1,000+. 

Gilmore Systems, 679 Switzar Ln„ 
Thousand Oaks, Calif. 91360, (805) 379- 
3210, fax (805) 379-1341. 

GLENCO 

ENGINEERING INC. Circle No. 111 

Hardlock Master Kit-OS/2 consists of a combi¬ 
nation of software and a small hardware key 
or internal board that attaches to a PC, It fea¬ 
tures an algorithmic response ASIC with 
optional RAM/ROM for field programma¬ 
bility, Systems available for parallel and seri¬ 
al ports, DOS, UNIX, Xenix, OS/2, Windows, 
CD-ROM, single-user and network configu¬ 
rations. Price: $225. 

Glenco Engineering Inc., ,270 Lex¬ 
ington Dr., Buffalo Grove, Ill, 60089, 
(800) 562-2543 or (708) 808-0300, fax 
(708)808-0313. 

INTELLIGENT 

ENVIRONMENTS Circle No. 112 

AM {Applications Manager} 4.0 is a program¬ 
ming environment for building and main¬ 
taining client/server applications. It enables 
you to develop 32-bit, multitasking, object- 
oriented applications. Other features include 
visual programming facilities. You can divide 
development among team members on a 
LAN through reusable components accessed 
from shared libraries. Price: $8,400 (includes 
one year of support and upgrades). 


AM (Applications Manager)/SQL 
Workbench 2.1 Is a visual development 
tool for designing, compiling, and test¬ 
ing static SQL transactions in an SAA 
environment. It enables client/server 
applications that otherwise would 
require dynamic SQL to execute multi¬ 
threaded static SQL. Price: $8,400 
(includes one year of support and 
upgrades). 

AM (Applications Manager) CP/Work¬ 
bench 2.0 is a graphical tool for creating 
and maintaining APPC transactions for 
"cooperative processing" client/server 
applications. It also aids in defining 
conversations and building and parsing 
communications buffers. Because the 
compiled definitions are maintained in 
a repository, subsequent modifications 
do not impact the application. Price: 
$8,400 (includes one year of support 
and upgrades). 

Intelligent Environments, Two 
Highwood Dr., Tewksbury, Mass. 
08176, (800) 669-2797 or (508) 640-1080, 
fax (508) 640-1090. 

IPSWITCHINC. Circle No. 113 

Vantage/IP 1.0 is TCP/IP software for OS/2 
with a set of OS/2 and DOS applications. 
You can use Vantage/IPs set of APIs to run a 
wide variety of third party TCP/IP applica¬ 
tions. Vantage/IP transfers data at speeds 
exceeding 500k bytes per second. Price: $390. 

Ipswitch Inc., 333 North Avenue, 
Wakefield, Mass. 01880, (617) 246-1150, 
fax (617) 245-2975. 

LANE 

TELECOMMUNICATIONS Circle No. 114 
Passport3000 4.0 is an OS/2 software applica¬ 
tion that allows an Intel-based PC, connected 
to a LAN, to act as a communications server. 
The Passport package supports up to 32 gate¬ 
ways including: e-mail, facsimile, telex, X.25, 
direct distance dialing, and leased lines, on a 
single system. Passport processes messages 
between gateways as a store and forward 
message handling system. It provides a set of 
administrative utilities both to monitor and 
manage the message traffic. You can generate 
detailed reports by user, communication line, 
and department. Price: $3,500-21,000+, 

Lane Telecommunications Inc., 5 
Marmeview Plaza, Ste. 210, Hoboken, 
N.J. 07030, (201) 7984)006, fax (201) 798- 
0045, 

MARKHAM 

COMPUTER CORP. Circle No. 11S 

NetOpPM 421 is a remote-control product for 
networked PCs. It allows the control of, 
screen view, and file transfer between any 
OS/2, DOS, or Windows PC in the LAN or 
WAN. It will remote-control servers as well 
as workstations. It supports NetBIOS and 
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Novell 1PX/SPX. Price: $1,495 for a master 
and up to 50 remotes; $795, each additional 
master- 

Markham Computer Corp., One S. 
Ocean Blvd*, Ste. 207, Boca Raton, Fla* 
33432, (800) 262-7542 or (407) 394-3994, 
fax (407) 394-3844. 

MERGENT 

INTERNA TtONAL INC * Circle No. 116 

PC/DACS 1,03 for OS/2 includes features like 
ID and password-based protection for OS/2 
2*x platform; session time-out; boot protec¬ 
tion (dual-boot combined with PC/DACS for 
DOS); several levels of encryption; and multi¬ 
user set up* It is transparent to users and pro¬ 
tects information without impeding perfor¬ 
mance- You can accomplish enterprise-wide 
administration through Site/DACS. You can 
customize PC/DACS per organizational 
security requirements, then deploy and 
install it across thousands of workstations. 
Price: $189, unit; $4/>0Q for site license of 25 
units (includes Site/DACS). 

Mergent International Inc., 70 
Inwood Rd„ Rocky Hill, Conn. 06067, 
(203) 257A223, fax (203) 257-4245. 

MfCROFORMA TIC/AMERICAN 
TELEREP INC. Circle No. 117 

Fax/PM LAN 3.0 \s a client/server that uses 
Distributed SOM. It supports NetBios, Nov¬ 
ell, and TCP/IP. Fax/PM LAN also supports 
DOS, Windows, and OS/2 clients- Its Restart 
checkpoint allows you to resume transmis¬ 
sion from point of failure. FaxPM supports 
multipie user-definable channels and multi¬ 
ple phone lines in send and receive mode. 
Features include workgroup and private 
phone books for e-mail; fax routing from DID 
and DTMF; and CID installation. REXX and 
SOM API's are included with program. 

Microforma tic, 2 rue Navoiseau, 
Montrevil-Sous-Bois, F-93100 France, 
33(1)48-70-19-00, fax 33(1)48-70-27-29. 
American TeleRep Inc*, 610 Niederwer- 
fer, South Windsor, Conn. 06074, (203) 
644-1708, fax (203) 648-9587. 

MICRO WORK INC. Circle No. 116 

Job Scheduling Server 10 is an OS/2 32-bit PM 
version of the Job Scheduler for IBM and 
Novell LANs* It schedules OS/2, Windows, 
and DOS jobs. It allows unattended job 
scheduling on specified or auto-selected 
nodes and conditional job scheduling based 
on other jobs return codes or presence files. 
An on-line LOG keeps screens and messages 
captured during job execution* Job Schedul¬ 
ing Serv er controls the number of jobs con¬ 
currently executing on the same node. Fea¬ 
tures include job priority, calender, and secu¬ 
rity* Ships on May 15,1994* Price: Please call. 

Micro work Inc., 47 W. St. Andrews 
Ln., Deerfield, III 60015, (708) 940-8979, 
fax (708) 940-8979* 


NETTECH 

SYSTEMS INCl Circle No. 119 

Nettech RFgate 1.3 is a host gateway to wire¬ 
less digital radio networks, including Ardis 
and RAM Mobile Data* The API allows host 
applications to run on OS/2 or application 
stubs to route data to or from other hosts 
from OS/2 gateway. Price: $695 run time, 
$4,695 for SDK. 

Nettech RFfink 2.0 is a transport 
designed for wireless digital radio net¬ 
works, It runs on OS/2 under Nettech 
RFgate and can simultaneously send 
and receive multiple messages or files 
from multiple destinations mobile units* 
Requires Nettech RFlink for DOS or 
Windows on mobile side. Price: $895 
run time; $2,695 SDK. 

Nettech Systems Inc., 324 Wall St*, 
Princeton, NJ. 08540, (609) 683-0100, fax 
(609) 683-5019. 

OPEN SOFTWARE 

ASSOCIATES Circle No. 120 

OpenUI 2 13 is a cross-GUI development sys¬ 
tem for client/server and stand alone appli¬ 
cations* It provides portability' across graphi¬ 
cal user interfaces and also manages the mes¬ 
saging between client and server systems* 
OpenUI provides scalability for enterprise¬ 
wide client/server applications. It supports 
C, C++, COBOL, Ada, Pascal, and fourth- 
generation languages; a wide variety of client 
and server platforms; and standard version 
control and testing tools. Price: Varies by 
platform and quantity. 

Open Software Associates, 20 
Trafalgar Sq., Ste* 414, Nashua, N.H. 
03053, (603) 886-4330, fax (603) 598*6877 
or 1250 Oakmead Pkwy., Ste. 210, Sun¬ 
nyvale, Calif. 94088-3599, (408) 730- 
2626, fax (408) 730-2619. 

PARALLEL PCS INC Circle No. 121 

Synedcs SDK 2.0 for OS/2 helps you to devel¬ 
op Synetics Aware applications that enable 
you to locate and apply idle processing 
resources to your processing needs. By using 
the idle resource found on LANs for parallel 
processing, you benefit from shorter execu¬ 
tion times. The Synetics SDK provides the 
source code, libraries, and documentation 
needed for you to build Synectics Aware 
applications* Price: $2,200. 

Parallel PCs Inc., 1404 Durwood 
Dr., Reading, Pa. 19609, (610) 670-1710. 

PEERLOGIC Circle No. 122 

PIPES Platform Developers Kit 15 is message- 
oriented middleware that provides an infra¬ 
structure for distributed computing* With it, 
you can build distributed applications that 
run over diverse operating systems and net¬ 
work protocols* PIPES Platform resides 
between the application and the network, 
providing communications services such as 


guaranteed message delivery, distributed 
naming services, resource location trans¬ 
parency, dynamic remuting and error recov¬ 
ery, and automatic context bridging between 
different network protocols. Price: $495; call 
for additional licensing information. 

PeerLogic, 555 DeHaro St., San 
Francisco, Calif. 94107-2348, (800) 873- 
7927 or (415) 626-4545, fax (415) 626- 
4710. 




PINNACLE 

TECHNOLOGY INC. Circle No. 123 

Desktop Observatory 3.0 allows you to config¬ 
ure desktops remotely and standardize OS/2 
clients regardless of network operating sys¬ 
tem. Features include mobile desktop and 
password security when you log on any 
workstation. You can protect the Observatory 
or use the DCE security service interface. 
Desktop Observatory helps you to prevent 
drags, deletes, copies, renames, moves, shad¬ 
ows, or just hide them* It launches your 
REXX or C based event* Price: $149. 

Pinnade Technology Inc*, P*0* Box 
128, Kirklin, Ind* 46050,' (800) 525-1650 
or (317) 279-5157, fax (317) 279-5157. 

QUADRON 

SERVICE CORP. Circle No. 124 

qCF3.5is a C4anguage development and run¬ 
time environment for multitasking commu¬ 
nications applications using IBM ARTIC 
coprocessor cards* It includes drivers, load¬ 
ers, and symbolic analysis debug tools. 
Application design consists of open/close, 
read/write concepts* Use qCF to develop 
BISYNC, ASYNC, SDLC/HDLC, and custom 
protocols* Price; $2,499, qCF Developer's 
Toolkit; $279, qCF Runtime Support* 

qX25 1.8, an open-architecture X*25 
implementation, uses IBM ARTIC cards 
and includes fast select support, com¬ 
munication statistics, packet and frame 
trace, and multiple lines per cards* All 
levels of X.25 are a single ARTIC task. 
You can specify up to 100 virtual cir¬ 
cuits per line, and adjust frame, packet, 
and time-out parameters. Price: $499, 
qX25 Developers Toolkit; $399, qX25 
Runtime Support, 

qLAPB 12. supports link-layer LAP- 
B protocol* It utilizes a qLAPB task in an 
IBM ARTIC coprocessor card and con¬ 
tains frame-level procedure code that 
implements LAP-B* The qLAPB task 
communicates with a users application 
through an API supplied with the soft¬ 
ware. Price: $699, qLAPB Developers 
Kit; $499, qLAPB Runtime Support. 

Quadron Sendee Corp*, 209 E. Vic¬ 
toria St*, Santa Barbara, Calif. 93101, 
(805) 966-6424, fax (805) 966-7630* 

RIGHTFAX Circle No. 125 

RightFAX3.5\s a LAN fax server that supports 
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LAN Manager, LAN Server, and NetWare as 
well as OS/2, DOS, and Windows worksta¬ 
tions. You can route incoming faxes manual¬ 
ly or automatically using direct-inward-dial- 
mg, DTMF, or PBX interface. The RightFAX 
E-Mail Gateway facilitates sending and 
receiving faxes from cc:Mail, Lotus Notes, 
and Microsoft Mail. Price: Please call. 

RightFAX, 4400 E. Broadway, Ste. 
312, Tucson, Ariz. 85711, (602) 327-1357, 
fax (602) 321-7456. 


SAS INSTITUTE INC. Circle No. 126 

SAS System 6.0 is an integrated suite of soft¬ 
ware products for enterprise-wide informa¬ 
tion delivery. It provides you with tools to 
access, analyze, and present data within an 
applications development environment. The 
SAS System includes modular components 
for cooperative and distributed process and a 
computer performance evaluation tool that 
allows systems analysts to collect, analyze, 
and report current usages. Other capabilities 
include database access, applications devel¬ 
opment, and client /server computing. Price: 
Please call. 

SAS Institute Inc. r SAS Campus 
Dr., Cary, NLC 27513, (919) 677-8000, 
fax (919) 677-8123. 


S-CUBED INC Circle No. 12? 

AnyClient 1.1 is an add-on, programmable, 
middleware layer that extends the capability 


of ODBC, ID API, DB-L1B, and QE-LIB. With 
AnyClient installed, you can write client soft¬ 
ware using visual development tools or 
DBMS tools. In practice, you use AnyClient 
to define a "client's view virtual database" 
mapped to real database objects, thus making 
everything, even multiple joins, look like a 
base table. In production, a translator inter¬ 
cepts all messages between clients and the 
server; remaps views to the appropriate 
tables; and invokes any stored procedures 
that may exist. You are free to tune and mod¬ 
ify your server. Price: $2,995 per LAN. 

SQL Server to DB2 Rapid Migrator 1.1 
enables automated migration of appli- 
cations from a Sybase/SQL Server envi¬ 
ronment to a DB/2 and DB2 6000 envi¬ 
ronment. It allows you to execute stored 
procedures and trigger code developed 
with SQL Server in a DB2 environment. 
It also permits one set of code to sup¬ 
port multiple environments, thus pre¬ 
serving investment in existing code and 
reducing maintenance. DB-Lib trans¬ 
parency software eliminates the need to 
make changes on the client side when 
changing server. Price: $2,995 for devel¬ 
opment system; $995 for OS/2 server 
production system. 

ProZPro 1.1 is a database design and 
code generation tool with both forward 
and reengineering capability* It pro¬ 
duces DDL and DML for most SQL- 


RDBM5 and generates Transact SQL, 
COBOL, and C. You can map and reuse 
data and code definitions from existing 
systems to new requirements. Pro2Pro 
then generates the remaining database 
definitions and code that is required to 
meet the requirements. It supports mul¬ 
tiple production platforms from the 
same set of requirements. Pro2Pro also 
supports change impact analysis and 
reporting; features automatic detection 
and generation of any required data 
conversion products; and facilitates tun¬ 
ing and denormalization. Price: $7,995. 

Forms2Data 1.1 is an RDBMS design 
and prototyping tool for client/server 
systems. Developers gather business 
requirements starting with how the 
application looks to the outside world 
and how information on the "forms" is 
related to other information, computed, 
and looked up. They specify the tasks to 
be performed and who performs them. 
Forms2Data then uses its "applied nor¬ 
mal ization" concepts to design the 
required database structure and gener¬ 
ate a functional prototype. The applica¬ 
tion is then tested using the prototyper 
and modified as required until the busi¬ 
ness functionality is achieved. The pro¬ 
totype can the be put into production 
"as is" or transferred to the implemen¬ 
tation tool, Pro2Pro. Price: $2,995. 


MEGA POWER FOR OS/2 BACKGROUND APPS 

► Set the priority OS/2 Apps in Full Screen or Window mode including Apps installed as icons. Get 
information to help prioritize DOS Apps. 

► BIG performance gains in heavy multitasking and/or memory overcommit scenarios or as little as 
two background Apps via prioritization. 

► Indepth Online Help with Tips, Questions and Answers NEVER BEFORE PUBLISHED Find out 
how faster machines just "spin" faster and mixing DOS and OS/2 is a disaster. 

► The most powerful Application ever designed for OS/2. It is more effective than multiple 
processors for Background Apps, 

► We are the steering wheel and gas pedal for OS/2. If you don’t have our products— 

YOU’RE OUT OF CONTROL! 

► "READY FOR OS/2”. 

► 32 bit Presentation Manager Application (works on OS/2 2,0 & 2.1). 30-Day money 
back guarantee! Absolutely required for ALL OS/2 systems. NEW LOWER PRICES. 

► Background Master 1/11 —32/64 priority levels. $l9/$29 

► Priority Master I/II—96/128 priority levels. $39/$49 

ScheduPerformance Inc. 

3474 N. University Dr. • Suite 217 • Sunrise, Florida 33351 

Voice (305) 486-8299, Fax (305) 486-5018 • M-F 10:00AM to 8:00PM EST 
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S-Cubed Inc., 1010 Washington 
Blvd., Stamford, Conn. 06901, (203) 323- 
0760, fax (203) 323-2007. 

SATORi AUTOMATION Circle No. 128 
ScriptMate 1,0 allows users, system analysts, 
and programmers to automate routine micro- 
to-mamSrame sessions. It is compatible with 
most 3270 formula tors on the market and 
comes packaged with versions for DOS, Win¬ 
dows, and OS/2. ScriptMate is teamed with 
ScheduleMate, a scheduler that allows users 
to schedule the execution of programs and 
batch files. Price; $295, single user; $995, five- 
user LAN. 

Satori Automation, 770 Old 
Roswell PL, Ste. D400, Roswell, Ga. 
30076-1649, (404) 640-0904, fax (404) 
518-3331. 

SERENGETt 

SYSTEMS INC , Circle No 1 12$ 

378QLink 2.5,0 provides 3780/2780 RJE for 
OS/2, UNIX, ADC, and MS-DOS. You can use 
it for EFT, EDI, PQS, ACH, claims filing, and 
other bisync (BSC) applications. It has a 
menu-driven interface that helps you to 
install, configure, and operate it. You can use 
the script language for unattended sessions. 
You can invoke Script sessions from custom 
applications. Multiple BSC ports can run on a 
single system. A variety of internal and exter¬ 
nal modems are supported. Price: $795-2,895, 


BSCUB 16.5 is a bisync (BSC) API 
for OS/2, UNIX, AIX, MS-DOS, and 
Windows, which gives you access to 
3780/2780 communications. You can 
use BSC LIB in RJE, EFT, EDI, POS, 
ACH, claims filing, and other BSC 
applications. The API shields program¬ 
mers from the details of the BSC proto¬ 
col. Auto-dial, auto-answer, and exten¬ 
sive status codes aid in unattended ses¬ 
sions. BSCLIB can control multiple BSC 
ports on a single system, A variety of 
modem options are available. Price: 
$595-2,895. 

Serengeti Systems Inc., 808 W. 10th 
St., Austin, Tex. 78701-2042, (800) 634- 
3122, fax (512) 480-8729. 

SOFTOOLS CORP. Circle No. 130 

CCCI Change and Configuration Controlf/Manag- 

er 2.1 for OS/2 is targeted at software devel¬ 
opers, technical testing staff, quality assur¬ 
ance personnel as well as production control 
and library managers, working either stand 
alone or on a network. CCC/Manager is part 
of Softool's CCC product family, offering life 
cycle management functionality across 20 
platforms including UNIX, IBM, Digital, and 
the PC. Features include an object-oriented 
user interface; modeless execution that per¬ 
mits simultaneous operations; central list that 
can be kept open all the time; and mirroring 
PC directories in CCC, CCC/Manager also 


provides support for concurrent development, 
w T hich allows users to work simultaneously on 
the same code, and a data management facility 
that allows you to unload information into 
tab-delimited files, CCC/Manager permits 
incorporation of CCC/Bridge in a distributed 
MVS/PC environment. 

Softools Corp., 340 S. Kellogg Ave., 
Goleta, CA 93117, (805) 683-5777, fax 
(508) 683-4105. 



SOFTWAREAG 

OF NORTH AMERICA Circle No, 131 

AD ABAS Server 12.5 Software AG's premier 
database management systems to the work¬ 
station. This implementation highlights 
ADABAS's well-known strengths of being 
able to handle both high transaction volumes 
and complex ad hoc queries, while operating 
against large volumes of data. Thus, 
ADABAS DB Server is well “positioned for 
many types of applications, both strategic 
and operational, ADABAS is supported 
across OS/2, Windows NT, UNIX, Open- 
VMS, DOS/VSE, VM/CMS and MVS operat¬ 
ing environments. Price: $500+. 

NATURAL (Application Develop¬ 
ment) is a fourth-generation environ¬ 
ment for users and developers. NAT¬ 
URAL'S interactive capabilities help 
users design, develop, test, manage, 
deploy, and maintain applications. 
Applications are performance-opti- 
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Connect to the LAN Server advantage 
with the help of our OS/2 SWAT Team. 

Let's face it, connectivity and communication is 
the key to the world. That's why weVe spent the 
last six years making these fields our specialty. 

We offer * OS/2 LAN Server Installation 

* OS/2 LAN Server training 

• Advanced LAN Server training 

* Full operational support 

• Custom fine tuning of your system. 

We also offer in-depth training in OS/2 
Administration, REXX Programming, Base 
Programming, OS/2 Presentation Manager, 

ANSI C, and Database Manager. 

Adaptive Research & Design Company 

Miami 

Call: (305) 899-0700 or Fax (305) 892-8669 


7W 

TUB Version Control 

For DOS, OS/2 and Windows-NT 

* The experts loved TL1B A: 

"...amazingly fast:., TUB is a great system. M PC Tech Journal 

“TUB has features and power to spare... TUB is easy to use and 
the fastest of the reviewed packages. " Computer Language 
"/ will not program without it, M Uptime Magazine 

* Now TUB 5.0 adds: 

Automatic branching. Automatic version labeling across branches. 
User defined promote structures, for staged development. Exclusive 
whole-level change migration for customized software. N-way-tree 
version numbers. Branch and full locking. OS/2 & NT support. 


• Plus the features they loved in TLIB 4: 

Check-in/out locking. Branching, for parallel development. Keywords. 
Full binary file support (does not depend upon CRs in the file like other 
products). Wildcard and iist-of-file support; can create lists by scanning 
source code for includes. Can merge (reconcile) multiple simultaneous 
changes and undo intermediate revisions. Network and WORM optical 
disk support. Main frame-compatible delta generator for Pansophic, 
ADR, !BM f Sperry formats. Includes integrated PD MAKE by L. Dyer; 
also integrates with Opus™ MAKE, Slick™ MAKE, others. 


MS-DOS $139, OS/2 & NT (with MS-DOS) $195 + shipping. 

5 station network: MS-DOS $419, OS/2 $595. Call for other sizes. 



Burton Systems Software 


PO Box 4156, Cary, NC 27519 (919) 233-8128 
FAX: 233-0716 
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mized for multi vend or distributed com¬ 
puting environments. NATURAL'S 
users benefit from easy-to-use graphical 
user interfaces, comprehensive HELP 
system, interactive development and 
testing, and transparent user access to 
LAN, midrange, and mainframe 
resources and portability of applica¬ 
tions, data and communications within 
diverse distributed environments* 

ENTIRE NET WORK (Distributed Data¬ 
bases) 2.1 allows applications residing 
on different platforms and in different 
geographical locations to appear to 
users as if data were residing on one 
platform in one location. Users can 
access multiple databases. For example, 
data can be extracted from remote data¬ 
bases, processed within a local session, 
and returned to the remote database. 
Users will have a singular view of 
enterprise data. An intuitive graphical 
user interface allows network adminis¬ 
trators to support and maintain the 
enterprise network. 

Software AG of North America, 
11190 Sunrise Valley Dr., Reston, Va. 
22091, (800) 423-2227 or (703) 860-5050, 
fax (703) 391-8360. 

SOFTWARE CORPORA TfON 

OF AMERICA Circle No. 132 

PotyPM/2 22 for OS/2 allows an OS/2 


"Teacher" PC to control a DOS, OS/2, or 
Windows "Pupil" PC. These PCs may be 
connected via modem, NetBIOS, APPC/ 
APPN, X.25, IPX, or TCP/IP. You can use 
Poly PM/2 for remote LAN support, training 
or customer support. Price; $295. 

TalkThru 22 for OS/2 provides ter¬ 
minal emulation, file transfer, scripting 
and EHLLAPI for network (connected 
via NetBIOS or TCP/IP) or modem- 
connected PCs. TalkThru's EHLLAPI 
support allows PCs to connect to both 
IBM and non-IBM hosts. Price: $190. 

Software Corporation of America, 
100 Prospect St., Stamford, Conn. 06901, 
(800) 966-7722 or (203) 359-2773, fax 
(203) 359-3198. 

THE SOFTWARE 

LIFELINE INC . Circle No. 133 

REM0TE-0S 2. W Multi-User for OS/2 is ready to 
use, or developers can take advantage of the 
toolkit to provide special support for, for 
example. Data Collection devices, and access 
OS/2 applications. Access is via RS232* Up 
to 48 concurrent terminals can share the 
OS/2 applications on a single OS/2 applica¬ 
tions server* Applications like cc:Mail, Word¬ 
Perfect, or even 3270 emulation can concur¬ 
rently be run from terminals like a VT100 or 
even a 3270 Mainframe terminal. Price: $99+. 

The Software Lifeline Inc., Execu¬ 
tive Court One, 2295 Corporate Blvd„ 


Boca Raton, Florida 33431, (407) 994- 
4466, fax (407) 994-6304* 

STRATEGIC SOLUTIONS 
INTERNA TIONAL CORE Circle No. 134 
Net/impact 1.0 is an SNA Resource and MVS 
Application Monitoring and Management 
System, Net/Impact SNA/Agent runs on an 
MVS host and can co-exist with NetView or 
Net/Master. Net/ Impact PM/Workstation 
runs on OS/2 2.x, providing network opera¬ 
tions interface. It provides service level objec¬ 
tives, real-time, dynamic network status, and 
automated or manual VTAM command 
interface. Price: Please call. 

Service Point/3215 is a NetView ser¬ 
vice point and OS/2 automation devel¬ 
opment platform. NetView FUNCMD, 
GENALERT, MSG, and VIEW support 
within OS/2 RFXX. It provides terminal 
emultion for VT-102, IBM 3101, ANSI 
3.164, UTBM 3164, and Glass TTY. Fea¬ 
tures include data scope, capture /simu¬ 
lation/playback facilities. Requires 
Communication Manager/2 but does 
not need ROPS or NetView/PC. It pro¬ 
vides communications via RS-232, 
Named pipes* Price: $3,000 or higher, 
depending upon configuration. 

Strategic Solutions International 
Corporation, 1075 Tolland Turnpike, 
Manchester, Conn. 06040, (203) 649- 
1900, fax {203} 649-1230* 



Read and Write dBASE files 
from your C/C++ programs! 


Full package: $ 195 
REXX only: $89 


dbfLIB 

Programmer’s Library 






A° 


New! 

Version 2 Features: 

^ Supports new index formats 
^ REXX support Included 
New streamlined functions 
^ Royalty free DLLs for Windows, OS/2 and Windows NT 
^ Re and record locking APIs 
^ Handle based calls 
^0- Memo field & index support 
^ Libraries for DOS, Windows, OS/2, and Windows NT 



dSOFT Devdopmtttl Inc 
4710 innsbmk Drive 
Houston. TX 77066 


Sales (405) 360-3045 

Tech Support (713) 537-0318 
Visa and MasterCard accepted. 


P 
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The Impact forma tied Entryfields are 

o completely new window class which allows 
the developer lo specify a format string 
when the entry field is created. Formatting 
can he used for fields like Phone Number, 
Dates, Social Security Number, elc. 

The Impact Formatted Entryfield 
dynamically formats itself as the 
user inputs data* 

The Impact formatted Entryfield 
support assures uniformity in 
data entry. 


I M (* ACI SOFTWARE 


The developer has complete control to create 
custom fields like; 

* Numeric entry only 

* Alpha characters only 

* Special delimiting characters 

* Value ranges 

* Currency support 
and, much more. 

Easy to use! Just change the window doss in 
your resource file. 

Download free demo of 
Impart Emryftelds from our 86$. 
[8)81879-7405 

Add Impact to your application 


588 ? Koran M. Td otfa & write 

iurt* 33G m 17(4390 

ApunKfe (818)879 5593 

a?mi [|l|] 879-5S93 


Circle Reader Service Number 47 


Circle Reader Service Number 48 








SYZYGY 

COMMUNICA HONS INC. Circle No. 135 
XAM/OS/21.0 provides file transfer between 
remote DOS and OS/2 workstations, 
between AS/400s and OS/2 workstations, 
and between any LAN (for example, OS/2 
LAN Server) and any other LAN (for exam¬ 
ple, NetWare). Price: $1,500. 

Syzygy Communications Inc., 269 
Ml Herman RcL, Stc. 201, 9cotts Volley, 
Calif. 95066, (408) 438-5111, fax (408) 
438-5115. 

TOKEN 

TECHNOLOGY INC. Circle No. 136 

RemoteVision 2.0 extends Token-Ring net¬ 
works to remote workstations and work¬ 
groups over asynchronous modems. LAN 
applications written to one of the LAN inter¬ 
faces like NetBIOS, APPC, 802.2, IPX, 
TCP/IP, or XNS work transparently over 
remote connections. RemoteVision supports 
the following configurations: remote-to-LAN, 
LAN-to-LAN, and remote-to-remote. Price: 
$695+, depending upon number of users. 

Token Technology Inc., 1265 Mon- 
tecito Ave., Ste. 101, Mountain View, 
Calif. 94043 (415) 965-8607, fax (415) 
965-8658. 

UNIFACE CORP. Circle No. 137 

UNIFACE 52 f or OS/2 is a development envi¬ 
ronment that helps you build client/server 


applications that take advantage of the native 
features of OS/2. Applications built with 
UNIFACE are open and portable and may be 
deployed throughout your entire enterprise. 
In addition to OS/2, UNIFACE is supported 
on many hardware platforms, operating sys¬ 
tems, GUIs, networks, and data servers. UNI¬ 
FACE for OS/2 is a native 32-bit OS/2 2.x 
application. UNIFACE applications adopt the 
native look and feel of Workplace Shell, sup¬ 
porting new controls including the Notebook 
Settings Object. Price: $2,495. 

Uniface Corp., 1320 Harbor Bay 
Pkwy., Ste. 100, Alameda, Calif. 94025, 
(800) 365-3608 or (510) 748-6145, fax 
(510) 748-6150. 

WALL DATA INC. Circle No. 138 

RUMBA for the Mainframe 3.2 brings IBM main¬ 
frame applications to the PC. It supports 
interfaces and LAN connections, including 
high-speed and dial-up async SNA connec¬ 
tions, and implements APPC for client/serv¬ 
er applications. Price: Please call. 

RUMBA for NetWare System brings 
IBM mainframe applications to the PC. 
It supports NetWare gateways—Net¬ 
Ware for SAA or the Microdyne EXOS 
(formerly NetWare) SNA Gateway—via 
IPX/SPX. RUMBA for the Mainframe 
includes Novell LAN Workplace 
TCP/IP protocol stack. Price: Please 
call. 


Wall Data Inc., 17769 NE 78th PL, 
Redmond, Wash. 98052, (800) 222-0861 
or (206) 881-5995, fax (206) 861-3175. 

XDB SYSTEMS INC. Circle No. 139 

XDB-Workbench 32 is a DB2-compatible 
development and production environment 
available for PCs, LANs, and workstations. It 
consists of a DB2-compatible SQL database 
engine, a COBOL precompiler, and a suite of 
development and administrator utilities. The 
XDB-Workbench enables users to develop, 
test, and run COBOL programs with embed¬ 
ded SQL on PCs, LANs, and workstations. 
You can migrate programs to the mainframe. 
XDB-Workbench can be used stand-alone, as 
a client accessing any XDB-Server on a LAN, 
or connected to the mainframe DB2 via XDB- 
Link. Price: Please call. 

XDB-SQL RDBMS 3.2 is a database 
engine, running under Microsoft Win¬ 
dows that provides 100% of IBM's 
mainframe DB2 SQL on PCs, LANs, 
and workstations. XDB-SQL RDBMS 
includes XDB's SQL DLL Engine for 
Windows, an ODBC driver, a DDE 
interface, and a redirector for LANs. 
XDB's DLL SQL Engine for Windows is 
multiuser and capable of supporting 
multiple concurrent Windows applica¬ 
tions. Applications written in C or inter- 
facing to ODBC or DDE can access 
XDB-SQL RDBMS. XDB-SQL RDBMS 



OS2TREE™ 

See your entire system graphically at a glance! 
"What XTREE GOLD is to DOS and More! 
And What Norton Commander Missed" 

• Completely programmable: every function/key can be 
customized! 

• Display your tree structure for all system and IAN disks 

con current ly! 

• Manipulate your files, directories, entire disks 
and/or entire system! 

• HPFS fully supported 

• Popup list of files for any directory 

• Edit/browse file(s) using any EDITOR or PROGRAM! 

• Extensive FILE Search and Tree directory' search 
capabilities make locating files and/or data easy. 

• Upload/download files between mainframe and PC 

• Secure delete (sensitive files wiped clean) 

Intro Price: $79.99 
Professional Version: $249.99 
Limited time special $150.00 
Network Licenses Available 

LEVINE COMPUTER 
CONSULTING SERVICES 

7640 Provincial Dr., Suite 213, McLean, VA 22102 

Orders only (800) 383-9495 

FAX/Inquiries/Helpline (703) 790-1660 


We’d like to say a word about 
client/server development. 

TESTING. 

You've chosen the platform, architecture, 
development tools, and application. Now’s 
the time to decide how you're going to test 
your client/server applications. 

The Softbridge Automated Test Facility (ATF) 
is the only product that lets you construct 
your test cases to replicate realistic client/ 
server scenarios. With ATF, your tests can 
run the client/server gamut from conditions 
such as lockout and concurrent requests, to 
more complex "real world" test cases in 
which end-user tasks are tightly intertwined. 

If you're building client/server (or stand¬ 
alone) applications under OS/2 or Windows, 
you should be using ATF to test them. To 
learn more about ATF, call 800-955-9190. 


i Softbridge, Inc. 
617-576-2257 (Phone) 
617-864-7747 (FAX) 


ATF: The final 
word in testing. 
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can be used in a stand-alone environ¬ 
ment against a local Windows SQL 
Engine, as a client workstation access¬ 
ing any XDB Database Server on a 
LAN, or connected to mainframe DB2 
via XDB-Link. XDB-SQL RDBMS runs 
under DOS, OS/2, and Windows. Price: 
Please call. 

XDB-SQL C SDK 32 comes with a C 
precompiler and a C-API. XDB's SQL 
Engine's features include referential 
integrity, distributed database access, 
transaction processing, backup and 
recovery, authorization, concurrency 
control, and system catalog. C program¬ 
mers can embed SQL into a program or 
call SQL engine functions using a pow¬ 
erful C function call library. Applica¬ 
tions written using XDB-SQL C SDK 
can be used either in a stand-alone envi¬ 
ronment against a resident SQL engine, 
as a client workstation accessing any 
XDB-Server on a LAN, or connected to 
mainframe DB2 via XDB-Link. Price: 
Please call. 

XDB-Server 32 is a 32-bit, multiuser 
database system that features referential 
integrity, distributed database access. 


Andersen Consulting 

(800) 458-8851 or (312) 507-5161 

Capstone Software Inc., 

(800) 500-2244 or (317) 848-2414 

cfSOFTWARE Inc., 

(800) 366-8756 or (708) 824-7180 

Client Server Networking Inc., 

(203) 233-2951 

Computer Associates International Inc., (800) 
225-5224 or (516) 225-5224 

Development Technologies Inc., 

(803) 790-9230 

Easel Corp., 

(800) 759-5880 or (617) 221-2100 

Eicon Technology Corp., 

(514) 631-2592 

Gateway Systems Corp., 

(800) 333-9366 or (517) 337-8960 

Gilmore Systems, 

(805) 379-3210 

Glenco Engineering Inc., 

(800) 562-2543 or (708) 808-0300 

Intelligent Environments, 

(800) 669-2797 or (508) 640-1080 

Ipswitch Inc., 

(617)246-1150 


transaction processing, backup and 
recovery, authorization, concurrency 
control, and system catalogue tables. 
Version 3.3 (available First Quarter, 
1994) includes compatibility with DB2 
3.0, query optimization enhancements 
in read-only isolation levels, a governor 
that allows the user to limit the number 
of records retrieved, and server-to-serv- 
er communications. Clients running 
under Windows NT, Windows, OS/2, 
and DOS provide user interfaces that 
gather input and prepare requests for 
the XDB-Server. The XDB-Server pro¬ 
vides storage, access, and control of 
data. Because the XDB-Server is net¬ 
work-independent, DB2 compatibility 
can exist on multiple platforms includ¬ 
ing Windows NT and OS/2. Any of 
XDB's development, fourth-generation 
language, and reporting tools, as well as 
third-party tools including Power¬ 
Builder, can act as clients to the XDB- 
Server. Price: Please call. 

XDB-Link 2.0 contains a set of inter¬ 
face software that links SQL applica¬ 
tions on PCs, LANs, and workstations 
to DB2 data residing on the mainframe. 


BUYER S GUIDE INDEX 

Lane Telecommunications Inc., 

(201) 798-0006 

Markham Computer Corp., 

(800) 262-7542 or (407) 394-3994 

Mergent International Inc., 

(203) 257-4223 

Microformatic, 

33(1)48-70-19-00 or (203) 644-1708 

Micro work Inc., 

(708) 940-8979 

Nettech Systems Inc., 

(609) 683-0100 

Open Software Associates, 

(603) 8864330, (408) 730-2626 

Parallel PCs Inc., 

(610) 670-1710. 

PeerLogic, 

(800) 873-7927 or (415) 6264545 

Pinnacle Technology Inc., 

(800) 525-1650 or (317) 279-5157 

Quadron Service Corp., 

(805) 966-6424 

RightFAX, 

(602) 327-1357 

SAS Institute Inc., 

(919) 677-8000 


The XDB-Link product consists of two 
components: XDB-Link Gateway, 
which resides on the PC, and a XDB- 
Link Host, which resides on the main¬ 
frame. These components communicate 

via LU 6.2 protocols to satisfy DB2 5QL 

requests made from PCs, LANs, and 
workstations. XDB-Link is based on a 
client/server architecture. It supports 
DOS, OS/2, and Windows clients. In a 
development environment, XDB-Link 
extends systems level testing to the PC 
environment by providing access to 
mainframe production data. In a pro¬ 
duction environment, XDB's applica¬ 
tion tools and LAN applications can 
now access DB2 data residing on the 
mainframe. XDB-Link Gateway pro¬ 
vides direct access to IBM's relational 
databases, including DB2, SQL/400, 
and DB2/VM via DRDA. In addition, 
XDB-Link Host provides direct access 
to non-relational databases via Remote 
Procedure Calls (RPCs). Price: Please 
call. 

XDB Systems Inc., 14700 Sweitzer 
Ln., Laurel, Md. 20702, (301) 317-6800, 
fax (301)317-7701. 


S-Cubed Inc., 

(203)323-0760 

Satori Automation 

(404) 640-0904 

Serengeti Systems Inc., 

(800) 634-3122 

Softools Corp., 

(805) 683-5777 

Software AG of North America, 

(800) 423-2227 or (703) 860-5050 

Software Corporation of America, 

(800) 966-7722 or (203) 359-2773 

The Software Lifeline Inc., 

(407) 9944466 

Strategic Solutions International Corporation, 

(203) 649-1900 

Syzygy Communications Inc., 

(408) 438-5111 

Token Technology Inc., 

(415)965-8607 

Uniface Corp., 

(800) 365-3608 or (510) 748-6145 

lVa// Data Inc., 

(800) 222-0861 or (206) 881-5995 

XDB Systems Inc., 

(301) 317-6800 
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LEARN OBJECTS FAST 

DEVELOPMSE 



Want to 
know the 
fastest way to 
learn objects- 
even for C++ 
developers? The 
experts recommend 
SmalltalkN, the technology 
that's 100% pure objects. 


FASTER, EASIER LEARNING. 


With C++, you have to 
accomplish two huge tasks: 
learning object class libraries, 
and learning new C++ language 
syntax. Plus C++ is a hybrid of C 
with added object extensions. So 
odds are, you 'll find yourself con¬ 
stantly falling back on familiar 
procedural methods and losing 
the benefit of objects. 

SmalltalkN has a simpler, 
more approachable language 
that lets you focus on 
learning objects instead 
of a new syntax. That's 
why thousands of profes¬ 
sional programmers have 
found SmalltalkN to be 
the fastest, most efficient 
way to (earn the object- 
oriented paradigm. In fact, 


Smalltalk/V to the rescue. Simply 
by enabling large programs to be 
built from pretested software 
objects, it can provide tenfold 
leaps in programmer productivity 
and software quality. Perhaps 1 
more important, Smalltalk pro 
grams deal in terms programmer 
understand 







C++ will make 
more sense once 
you learn OOP 
with SmalitalkA/. 

But we think you’ll want to con¬ 
tinue using SmalitalkAt for your 
application development. 


DEVELOP lOx FASTER. 


Greg i/oss of Windows lech 
journal says: "It's notan exag¬ 
geration to say that most applica¬ 
tions of significant size can be 
built ten times faster in 
SmalitalkA/ than in C or C ++." 
Gen Kiyooka of Windows Tech 
Journal agrees:"Nothing on 

earth can match the effi¬ 
ciency and productivity 
of experienced 
Smalltalk/V program¬ 
mers. Nothing." And 
Business Week reminds 
us that some Wall Street 
firms now get their 
“computer models of 
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SMALLTALK/V* 100% PURE OBJECTS* 


brand-new finan¬ 
cial instruments 
done in days, not 
months." 


EASY TO USE. 


Here’s how Smaiitalk/V 
cuts development 
time by as much as 
90%. •Easy-to-use 
integrated environ¬ 
ment. •Incremental compilation 
shows immediate results of code 
changes. •Over 350 well-tested 
reusable classes built-in and 
100's more available. •Class 
browsers and object inspectors 
to examine code and isolate 
errors. •Automatic memory man¬ 
agement to eliminate memory 
related bugs. • Easy access to 
3GL languages. •Integrated 
graphic debugger. •Available on 
Windows 3.1, Windows NT, OS/2 
and Macintosh. 

So if you want to learn objects 
fast - and develop lOx faster - 
punch this line of code into your 
telephone: (800) 531-2344 
Department 706. We'll send you 
complete information. 
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Visual is just the beginning 



Why settle for ordinary visual when new 
Borland C++ gives you so much more? 
The highest quality fourth-generation 
tool set. A fully customizable and open 
desktop. The ability to target 
16- and 32-bit 
Windows simul¬ 
taneously. And, 
of course, it’s 
“visual.” 

Only Borland C++ 
gives you a fully 
integrated profes¬ 
sional editor featuring BRIEF® tech¬ 
nology, powerful Turbo Debugger® GX, 
and integrated C and C++ VBX control 


support. 


An environment to die for 

Borland C++ 4.0 takes the bureaucracy 
out of development. With the visual 
Project Manager and its multi-target 
capabilities, even the most complex 
projects are handled automatically. 

The flexibility of AppExpcrt actually 


generates much of your application for 
you. TargetExpert, ClassExpert, Dialog- 
Expert, and Resource Workshop™ 
streamline the tasks of setting up and 
customizing your applications. 

A true C++ implementation 
that's years ahead 

Languages evolve for a good reason— 
so programmers can realize ever- 
increasing productivity and safety of 
code. That’s why Borland is the first to 
bring important new enhancements to 
the C++ language, like full support 
for templates, exception handling, 
and Run-time Type Information. And 
Borland C++ includes ObjectWindows™ 
Library (OWL) 2.0—the world’s most 
popular framework. 

Borland C++ is the world-standard 
C++ because it’s the easiest to use, 
yet has power to spare for the most 
complex tasks. If you’re serious about 
C++ programming, new Borland C++ 
4.0 is the environment you’ve got to 
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have. After all, if your compiler is only 
visual, it’s just a facade. Get new 
Borland C++ 4.0 for Windows and DOS 



90-day, money-back guarantee! 

I See your dealer or call now, I 
1 1 -800-336-6464, exL7158 1 

^n Canada call, 1-800-461-332^. 

Borland” 

Power made easy™ 

G362-0001-22 















































